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Preface 



The objective of this book is to help installation managers and system programmers 
plan for, install, and use SMF in an MVS system. This book explains: 

• The five categories of information gathered by SMF data-collection routines. 

• When each SMF record is written and the information contained in each record. 

• The basic relationship of SMF to the operating system and to user-written exit 
routines. 

• How to add user-written exit routines to the appropriate SMF exits either before 
or after SYSGEN. 

• The system areas that require additional storage for SMF and approximately how 
much additional storage is needed in each area. 

• How to execute the SMF dump program. 

• How to use an SMFPRMxx member of SYSl.PARMLIEl to define the use of SMF. 

• How to write records to installation-defined or SMF-defined data sets. 

• How to plan and write exit routines that will monitor jobs or job steps at various 
points during their processing cycle. 

• How to test user- written routines using the TEXTEXIT procedure. 

• How to use sort/merge programs to sequence SMF data. 

• How to design report programs that format and print the data from SMF records. 

Related Publications 

The reader should be familiar with the information presented in the following 
publications: 

• Operator's Library: IBM 3850 Mass Storage System (MSS) Under OS/VS, 
GC35-0014. describes the VARY ONLINE,S and VARY OFFLINE,S commands, 
which cause SMF to produce record type 22. 

• Operator's Library: OS/VS2 Reference (JES2), GC38-02 10, and Operator's 
Library: OS /VS2 Reference (JES3), GC38-0226, describe the HALT EOD and 
SWITCH SMF commands, which dump the SMF data sets; they also describe 
several other commands that cause SMF to produce records. 

• OS/VS Data Management Services Guide, GC26-3783, describes the record 
descriptor word (RDW), which is used to write records in the SMF data sets. 

• OS/VS Message Library: VS2 System Codes, GC38-1008, defines system 
completion codes. 

• OS/ VS Message Library: VS2 System Messages, GC3a- 1 002, explains SMF 
messages. 
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• OS/VS Utilities, GC35-0005, describes the IEBUPDTE, IEBDG, IEBPTPCH, 
IFASTATR, and IEHUCAT utility programs, which are used to: 

1) Enter an SMFPRMxx member into SYS1 .PARMLIB. 

2) Generate samples of standard parameter lists for user-written exit routines. 

3) Obtain listings.of sample routines. 

4) Format and write information from SMF record type 21 . 

5) Update an OS catalog to the level of a VSAM catalog. 

• OS/VS- VM/3 70 Assembler Programmer's Guide, GC33-402 1 , illustrates the 
ASMFCL cataloged procedure, which assembles and link-edits user-written exit 
routines. 

• OS/VS2 Conversion Notebook, GC28-0689, summarizes SMF compatibility 
between SVS and MVS and between MVT and MVS. 

• OS/VS2JCL Reference, GC28-0692, summarizes the OUTLIM parameter, which 
is used with user-written IEFUSO exit routines. 

• OS/VS2 System Data Areas, SYB8-0606, describes the TIOT, JFCB. DCB, DEB 
and UCB data areas contained in SMF record types 14 and 1 5. 

• OS/ VS2 System Programming Library: Initialization and Tuning Guide, 
GC28-0681, describes :>■ 

1 ) The MLPA parameter which is used for testing user-written exit routines. 

2) Several examples for using SMF to supplement MF/1 as a performance 
measurement tool. 

3) The service, transaction active time, and performance group number fields in 
SMF record types 4, 5, 34, 35 and 72. 

• OS/VS2 System Programming Library: JES2, G('23-()001 . and OS/VS2 System 
Programming Library: JES, GC28-0608, describes the JES2 and JES3 
initialization parameters that specify the characteristics to be associated with a job class. 

• OS/ VS2 System Programming Library: Job Management, GC28-0627. describes 
the HASPRSCN exit, which interprets variables in the JOB card accounting field 
before the IEFUJV exit receives control. 

(For information on the PL/1 and Sort/Merge program products, see PL/1 Language, 
SC33-0009, and OS/VS Sort/Merge Programmer's Guide, SC33-4035.) 
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The objective of this book is to help installation managers and system programmers 
plan for, install, and use SMF in an MVS system. This book explains: 

• The five categories of information gathered by SMF data- collect ion routines. 

• When each SMF record is written and the information contained in each record. 

• The basic relationship of SMF to the operating system and to user-written exit 
routines. 

• How to add user-written exit routines to the appropriate SMF exits either before 
or after SYSGEN. 

• The system areas that require additional storage for SMF and approximately how 
much additional storage is needed in each area. 

• How to execute the $MF dump program. 

• How to use an SMCTRMxx member of SYS1.PARMLIB to define the use of SMF. 

• How to write records to installation-defined or SMF-defined data sets. 

• How to plan and write exit routines that will monitor jobs or job steps at various 
points during their processing cycle. 

• How to test user-written routines using the TEXTEXIT procedure. 

• How to use sort/merge programs to sequence SMF data. 

• How to design report programs that format and print the data from SMF records. 

Related Publications 

The reader should be familiar with the information presented in the following 
publications: 

• IBM 3800 Printing Subsystem Programmer's Guide, GC26-3846, describes 
programming support for the 3800 Printing Subsystem. Several fields in record 
type 6 provide information on the activity of the 3800. 

• Operator 's Library: IBM 3850 Mass Storage System (MSS) Under OS/ VS, 
GC35-0014. describes the VARY ONLINE,S and VARY OFFLINE,S commands, 
which cause SMF to produce record type 22. 

• Operator's Library: OS/VS2MVS System Commands, GC38-0229, describes the 
HALT EOD and SWITCH SMF commands, which dump the SMF data sets; it 
also describes several other commands that cause SMF to produce records. 

• OS/ VS Data Management Services Guide, GC26-3783, describes the record 
descriptor word (RDW), which is used to write records in the SMF data sets. 

• OS/ VS Message Library: VS2 System Codes, GC38-1008, defines system 
completion codes. 

• OS/ VS Message Library: VS2 System Messages, GC38- 1 002, explains SMF 
messages. 
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• OS/VS Utilities, GC35-0005, describes the IEBUPDTE, IEBDG, IEBPTPCH, 
IF AST ATR, and IEHUC AT utility programs, which are used to: 

1) Enter an SMFPRMxx. member into SYS1 .PARMLIB. 

2) Generate samples of standard parameter lists for user-written exit routines. 

3) Obtain listings of sample routines. 

4) Format and write information from SMF record type 21 . 

5) Update an OS catalog to the level of a VSAM catalog. 

• OS/ VS- VM/3 70 Assembler Programmer 's Guide, GC33-402 1 , illustrates the 
ASMFCL cataloged procedure, which assembles and link-edits user-written exit 
routines. 

• OS/VS2 Conversion Notebook, GC28-0689, summarizes SMF compatibility 
between SVS and MVS and between MVT and MVS. 

• OS/VS2JCL Reference, GC28-0692, summarizes the OUTLIM parameter, which 
is used with user-written IEFUSO exit routines. 

• OS/VS2 System Data Areas, SYB8-0606, describes the TIOT, JFCB, DCB, DEB 
and UCB data areas contained in SMF record types 14 and 1 5. 

• OS/VS2 System Programming Library: Initialization and Tuning Guide, 
GC28-0681, describes: 

1) The MLPA parameter which is used for testing user-written exit routines. 

2) Several examples for using SMF to supplement MF/1 as a performance 
measurement tool. 

3) The service, transaction active time', and performance group number fields in 
SMF record types 4, 5, 34, 35 and 72. 

• OS/ VS2MVS System Programming Library: JES2, GC23-0002 and OS/VS2 System 
Programming Library : JES3, GC28-0608, describe the JES2 and JES3 initializa- 
tion parameters that specify the characteristics to be associated with a job class. 

• OS/VS 2 System Programming Library: Job Management, GC28-0627, describes 
the HASPRSCN exit, which interprets variables in the JOB card accounting field 
before the IEFUJV exit receives control. 

(For information on the PL/1 and Sort/Merge program products, see PL/1 Language, 
SC33-0009, and OS/VS Sort/Merge Programmer's Guide, SC33-4035.) 

Notational Conventions 

The parameters and instructions shown in this publication use the following 
notational conventions: 

• Bold type letters, words, and symbols: code them exactly as shown. 

• Italic type letters, words, and symbols: substitute specific information. 

• \f> (blank characters): code a blank. 

• { } (braces): code only one of the items or use the default value. Do not code 
the braces. 

• [ ] (brackets): code any enclosed item or items - they are optional. Do not 
code the brackets but specify commas if they are included with the items 
enclosed in the brackets. 

• | (OR signs): select only one of the items separated by the OR signs. 

• Underscores: if you do not code a value, the underscored one is the default. 
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Notational Conventions 

The parameters and instructions shown in this publication use the following 

notational conventions: 

• Bold type letters, words, and symbols: code them exactly as shown. 

• Italic type letters, words, and symbols: substitute specific information. 

• ty (blank characters): code a blank. 

• { } (braces): code only one of the items or use the default value. Do not code 
the braces. 

• [ J (brackets): code any enclosed item or items - they are optional. Do not 
code the brackets but specify commas if they are included with the items 
enclosed in the brackets. 

• | (OR signs): select only one of the items separated by the OR signs. 

• Underscores: if you do not code a value, the underscored one is the default. 
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Summary of Amendments 

forGC28-0706 

VS2 Release 3:7 



This publication is a major revision of OS/VS System Management Facilities (SMF), 
order number GC35-0004-6. It contains only VS2 information. 



Programming Features 

• Record type 6 (Output Writer) — In the description of an incomplete record 
type 6, the form number has been deleted from the list of fields that are zero. 

• Record type 22 (Configuration) - The 40 bytes describing the 3850 Mass 
Storage System (MSS) units online at IPL have been defined. 

• Record type 64 (VSAM Component Status) - Five new record fields describing 
data set characteristics have been added. 

• Record types 63 (VSAM Entry Defined) and 67 (VSAM Entry Deleted) - These 
records have been added to the IFASMFR macro instruction. 

• SMFFRMT program — This sample PL/1 source report program has been changed 
to format SMF record types 0, 2, 3, 7, 9, 10, 11 and 17-22. 

• SMF dump program return code — A X'10' return code in register 15 indicating 
that the operator attempted to dump the active SMF data set has been added. 

• Modifying JCL statements — A restriction for adding or modifying JCL-state- 
ment operand fields has been added to the IEFUJV exit. 

• Common exit parameter area - Offset 3 1 of the common exit parameter area 
has been changed from a "reserved" field to a field containing the job class. 

• VSAM records — A note indicating that VSAM record types 62 and 64 are not 
generated for system tasks has been added. If a system task caused VSAM 
record types 63, 67, 68 or 69 to be written, a note has been added to show that 
specific fields will be blank or zero. 



Publication Features 

• VS1 information — All VS1 information has been removed. 

• Dumping the SMF data sets - Two sample procedures for dumping the SMF 
data sets to a standard-labeled tape by means of the operator START command 
have been added. 

• User-written exit routines — The modules that interface with each SMF exit 
routine have been added. 
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• SMF records — The following information has been added to the SMF records: 

— The modules that write each SMF record. 

— The symbolic addresses of the SMF record fields as defined in the IFASMFR 
macro instruction. 

— The data area fields where SMF obtains the information for each field in 
each SMF record. 

• EXCP count — Appendix B has been added to describe the functions included 
and excluded in the EXCP-count fields of record types 4,14,15, 34, 40 and 
64. 

• CPU time — Appendix C has been added to describe the functions included and 
excluded in the CPU-time fields of record types 4, 5, 34 and 35. 

• Record descriptor word (RDW) - A note indicating that the address passed to 
the SMFWTM macro instruction must point to the RDW has been added. 

• Figure on SMF in the operating system — The system routines that pass control 
to the SMF exits have been added. 

• SMF storage requirements — Figure 4 has been added to summarize the additional 
storage required for SMF. 

• IEFUTL interlock warning — A sample ENQ macro instruction has been added 
to assist the IEFUTL user in minimizing the chances of a system interlock. 
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Introduction 



SMF (System Management Facilities) is a standard feature of MVS that collects and 
records several types of information: 

• Accounting information, such as CPU time, device usage, and storage usage. 

• Data set information, such as EXCP count and user identification. 

• Subsystem information, such as JES2 options and completion codes. 

• System information, such as system wait time and I/O configuration. 

• Volume information, such as space available on direct access volumes and error 
statistics for tape volumes. 

By creating analysis and report routines, installation managers or system 
programmers can use SMFrcollected information in a variety of ways. For instance, 
they can use it for accounting system usage or for measuring system performance. 

Note: SMF does not provide accounting support for: system tasks, subsystems, 
problem programs started from the console, and problem programs running in 
system keys. It does, however, produce records that describe the activities and 
events of the job entry subsystem. 

SMF also has exits that can link to user-written routines for monitoring a job or 
job step at various points during its processing cycle. The user-written routines can 
perform functions such as: cancel jobs, write user-defined records to the SMF data 
set, access installation-defined data sets, or enforce standards such as user 
identification, resource allocation, and maximum execution time. 

Because SMF data-collection routines and exit routines are independent of one 
another, one can use them in combination or separately. For example: by 
analyzing the information obtained by SMF data-collection routines, an installation 
manager can estimate a time limit for all jobs or job steps running on the system. 
Any job exceeding this time limit is automatically terminated. If, however, the 
installation manager would like to allow certain jobs to exceed the time limit, he or 
she can use the IEFUTL SMF exit to link to a user-written time-limit routine. 
Through the IEFUTL SMF exit, the execution time for selected jobs can be extended. 

Information Collected By SMF 

The information collected by SMF is formatted into many records that are 
categorized as follows: 

• Accounting records 

• Data set records 

• Subsystem records 

• System records 

• Volume records 
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The following sections list the types of records in each of these categories, and 
describe some of the information they contain. For a detailed description of each 
SMF record and its format, see the chapter "SMF Records". 



Accounting Records 

The SMF accounting records are: 

Type- 4 — Step Termination 
Type 5 Job Termination 
Type 6- JES2 Output Writer 
I Type 6 - JES3 Output Writer 
Type 20 — Job Initiation 
Type 26 -JES2 Job Purge 
Type 26 -JES3 Job Purge 
Type 34 - TS-Step Termination 
Type 35 - Logoff 
Type 40 - Dynamic DD 



These records describe the resources used by a job or job step. They include 
information such as: 

Job log and user identification 

Problem program name and start time 

Step name and number 

Job/step start and end times 

Amount of storage allocated and used 

Storage protect key 

Job/address space dispatching priority 

JES2 or JES3 job selection priority 

Job/step CPU time 

Accounting fields from JOB and EXEC statements 

I/O status indicators 

Job/step termination status 

Job/step completion code 

EXCP count, device class, unit type, and channel/unit address 

Page-ins, page-outs, swap-ins and swap-outs for both VIO and non-VIO data sets 

Service, transaction active time, and performance group number 

SYSOUT class and print/punch processor start and stop times 

JES2 or J ES3-assigned job number 

JES2 or JES3 logical output device name 

FCB and UCS image identification 

Converter, execution processor and output processor start and stop times 

Output lines and output punched cards 
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Data Set Records 

The SMF 4ata set records are: 

Type 14 - INPUT or RDBACK Data Set Activity 

Type 15 - OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity 

Type 1 7 «- Scratch Data Set Status 

Type 18 - Rename Data Set Status 

Type 62 - VSAM Component or Cluster Opened 

Type 63 - VSAM Entry Defined 

Type 64 - VSAM Component or Cluster Status 

Type 67 - VSAM Entry Deleted 

Type 68 - VSAM Entry Renamed m 

These records describe the characteristics, activity, and user of data sets. They 
include information such as: 

• Job log and user identification 

• Portions of the TIOT, JFCB, DCB, DEB and UCB data areas 

• Data set and catalog names 

• Number of volumes 

• Volume serial numbers 

• Extents on volume 

• EXCP count and device type 

• Number of records in data component 

• Record formats and lengths 

• Newly defined, altered, or deleted catalog entries 

Subsystem Records 

The SMF subsystem records are: 

Type 25 - JES3 Device Allocation 

Type 43 - JES2 Start 

Type 43 - JES3 Start 

Type 45 - J ES2 Withdrawal 

Type 45 - JES3 Stop 

Type 47 - JES2 SIGNON/Start Line 

Type 47 - JES3 SIGNON/Start Line 

Type 48 - JES2 SIGNOFF/Stop Line 

Type 48 - JES3 SIGNOFF/Stop Line 

Type 49 - J ES2 Integrity 

Type 49 - JES3 Integrity 

These records describe the activities and events of the job entry subsystem. They 
include information such as: 

• Number of tape and disk volumes fetched and mounted 

• Time and date of first mount message 

• Time and date of JES3 device verification 
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• JES2 or JES3 options 

• Start/warm start indicator 

• Withdrawal/abnormal termination indicator 

• JES2 or JES3 completion code 

• Remote name, line name, password 

• Length and text of SIGNON message 

• Number of EXCPs 

• Number of negative acknowledgements to write text 

• Number of data checks and time outs to read text 

• Line adapter address 

System Records 

The SMF system records are: 

Type - IPL 
Type 2 — Dump Header 
Type 3 - Dump Trailer 
Type 7 - Data Lost 
Type 8 - I/O Configuration 
Type 9 - VARY ONLINE 
Type 10 — Allocation Recovery 
Type 1 1 - VARY OFFLINE 
Type 22 - Configuration 
Type 31 - TIOC Initialization 
Type 70 - CPU Activity 
Type 71 - Paging Activity 
Type 72 - Workload Activity 
Type 73 - Channel Activity 
Type 74 — Device Activity 

These records describe the system configuration and SMF options in effect, give 
system statistics, and record the occurrence of specific events. They include 
information such as: 

• Job log and user identification 

• SMF options 

• Real and virtual storage sizes 

• Count of SMF records generated but not written during period when SMF data 
sets were not available for recording 

• Start and end times of period without SMF recording 

• Device class, unit type, and channel/unit address 

• MSS units online at IPL 

• Status of CPU, storage range, channel and MSS device following VARY 
command 

• Number of TS buffers 

• OWAIT and RESTART thresholds 

• CPU wait time 
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• Page-ins, page-outs, page reclaims, swap-ins, and swap-outs for both VIO and 
non-VIO data sets 

• Number of transactions terminated 

• Service, transaction active time, and performance group number 

• Workload level 

• Channel identifier 
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• Number of successful START I/Os issued to channel 

• Volume serial number 

• Number of requests serviced by device 

Volume Records 

The SMF volume records are: 

Type 1 9 — Direct Access Volume 

Type 21 - Error Statistics by Volume 

Type 69 - VSAM Data Space Defined, Extended, or Deleted 

These records describe the space available on direct access volumes, give error 
statistics for tape volumes, and describe data spaces in a VSAM catalog. By using 
the IFHSTATR utility program or user-written routines that examine the tape 
information, one can address problems of volume deterioration. (See "IFHSTATR" 
in OS/VS Utilities.) The volume records include information such as: 

• Number of unused alternate tracks 

. • Number of unallocated cylinders and tracks 

• Number of cylinders and tracks in the largest free extent 

• Owner identification 

• Volume serial number 

• Channel/unit addresses 

• Number of read and write errors 

• Volume on which data space is allocated 

• Catalog in which data space is defined 

• Number of free data space extents 



SMF In The Operating System 



Figure 1 summarizes the functions of SMF in the operating system. This section, 
which briefly describes Figure 1 , assumes that user-written exit routines are supplied 
for all SMF exits; all SMF-formatted records are written to the SMF data set; and 
user-written analysis and report routines are supplied. In any real application, of 
course, the user-written routines that are supplied and the records that are specified 
to be written to the SMF data set depend upon the installation's requirements. 

Initializing SMF 

During system initialization, the SMF initialization routine receives control from the 
master scheduler and: 

1 . Checks for the existence and validity of an SMFPRMxx member of 

SYS1.PARMLIB. This member contains the SMF parameters that define the 
use of SMF in the operating system. If SYS1.PARMLIB does not contain an 
SMFPRMxx member, (1) the operator may enter the SMF parameters from the 
console if OPI=YES was specified, or (2) the initialization routine uses the IBM- 
supplied default member SMFPRMOO. (For more information, see "SMFPRMxx 
Parameters" in the chapter "Defining the Use of SMF".) 
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MVS Control Program 



SYS1.PARMLIB 

i — ~^3r^ 



M J 



N SMFPRMxx 
Parameters 





Figure 1. SMF in the Operating System 
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2. Checks for the existence and availability of the SMF data sets, 

SYS 1 .MANX and SYS1 .MANY, if SMF recording was requested. If an error 
occurs, a message is issued indicating that recording on the SMF data sets is 
not allowed until the condition is corrected and the IPL procedure is repeated. 
If no errors occur, the initialization routine determines which SMF data set 
should receive records, as follows: 

If neither data set contains data, SYS 1. MANX receives the SMF records. 
If one data set contains data and the other one is empty, the partially 
filled data set receives the records. If both data sets contain data, the data 
set with the lesser amount of data receives the records. 

3. Creates the IPL record (type 0), the I/O configuration record (type 8), and 
the configuration record (type 22). These records are then written to the 
SMF data set. 

After the SMF initialization completes without error, the initialization routine 
returns control to the master scheduler so that processing of input streams may 
begin. 

Using User-Written Exit Routines 

Before each job control statement (or cataloged procedure) in the input stream is 
interpreted, the converter passes control to the SMF job validation exit, IEFUJV. 
A user-written IEFUJV exit routine can verify fields in the JCL statement, modify 
the JCL, or reject jobs that do not meet installation standards. The same user- 
written IEFUJV exit routine receives control for further validity checking after all 
of the JCL is converted and again after all of the JCL is interpreted. 

Before the initiator selects a job, it passes control to the SMF job initiation exit, 
IEFUJI. In a user-written IEFUJI exit routine, the user can decide whether to 
cancel or continue job processing based on accounting parameters associated with 
the job. Upon return from the routine, SMF creates the job initiation record 
(type 20) and writes it to the SMF data set. Similar processing occurs for each job 
step: before the initiator selects a job step, it passes control to the SMF step 
initiation exit, IEFUSI. 

When a job step terminates, either normally or abnormally, SMF produces a job 
step termination record (type 4) and, before the record is written, the terminator 
passes control to the SMF termination exit, IEFACTRT. A user-written IEFACTRT 
exit routine can modify the SMF type 4 record and create user records. It can also 
write these records to installation-defined or SMF-defined data sets. A user-written 
IEFACTRT exit routine also indicates whether the job is to continue and whether 
the type 4 record is to be written to the SMF data set. (Upon return, the type 4 
record is written unless the user-written IEFACTRT exit routine suppresses it.) 
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At job termination, SMF produces a job termination record (type 5) and, before 
the record is written, the terminator again passes control to the SMF termination 
exit, IEFACTRT, for similar record modification. (Upon return, the type 5 record 
is written unless the user- written IEFACTRT exit routine suppresses it.) 

After a job has terminated and all the SYSOUT output that pertains to the job 
(including the SMF output writer record (type 6)) is written, the job entry sub- 
system passes control to the SMF job purge exit, IEFUJP. A user-written IEFUJP 
exit routine can write additional data statistics to the SMF data set. Upon return, 
the SMF job purge record (type 26) is written to the SMF data set. 



Recording Events 

For specific events SMF collects and formats the following types of information: 

• Configuration information is recorded at IPL, when a VARY operator command 
is issued, and after allocation recovery. 

• Data set information is recorded when a data set opened by a user program is 
scratched, renamed, closed, or processed by end-of-volume (EOV). 

• Direct access volume information is recorded at IPL, when a HALT EOD or 
SWITCH SMF operator command is issued, and when a volume is demounted. 

• Subsystem information is recorded when (1) the job entry subsystem is started or 
stopped, (2) a line is started or stopped, (3) a remote user signs on or off, and (4) 
an invalid password is used. 

• System information is recorded at the end of specific lengths of time. 

The following SMF exits also receive control whenever specific events occur: 

• The time limit exit, IEFUTL, receives control from the timer interruption 
handler when the step CPU, job CPU, or continuous wait time limits are reached. 

• The SYSOUT limit exit, IEFUSO, receives control from the job entry subsystem 
when the number of records written to a spooled output data set exceeds the 
output limit for that data set. 

• The SMF record exit, IEFU83, receives control from the SVC 83 routine when 
an SMF record is ready to be written to the SMF data set. 

• The SMF dump exit, IEFU29, receives control from the SMF writer when an 
SMF data set becomes full. 

Dumping SMF Data Sets 

SMF initially writes records to the SYS 1 .MANX data set until it becomes full. 
When SYS 1 .MANX is full, SMF opens and uses the SYS1 .MANY data set to 
continue recording. When either SYS1 .MANX or SYS 1 .MANY becomes full, the 
SMF writer notifies the operator that the data set needs to be dumped, and then 
passes control to the SMF dump exit, IEFU29. For a detailed description of the 
IEFU29 exit, see the chapter "User-Written Exit Routines". For more informa- 
tion on the SMF dump program, see "Dumping the SMF Data Sets" in the chapter 
"System Requirements and Considerations". 
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The operator can use the HALT EOD and SWITCH SMF commands to cause 
SMF to switch recording from the active SMF data set to the inactive one. (These 
commands also cause SMF to record volume statistics and to empty the SMF buffer 
into the active SMF data set before it is switched.) After the recording is switched, 
the operator can use the SMF dump program to copy the inactive data set to the 
dump data set. The dump data set can then serve as input to user-written analysis 
and report routines. 

Using User-Written Analysis and Report Routines 

In addition to user-written exit routines, an installation may supply various routines 
that can: 

• Sort and merge the SMF records dumped by the operator from the SMF data set. 

• Analyze the sorted SMF data to detect excessive system wait time, inefficient use 
of I/O devices, or any other statistics that might lead to improved system 
throughput. 

• Report the data from selected SMF records and user-written analysis routines in 
an appropriate format. 
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System Requirements and Considerations 



To record SMF data, an installation must define how it will use SMF (see the chapter 
"Defining the Use of SMF"), add user-written exit routines to the control program, 
allocate direct access space for the SMF data sets, and catalog the SMF data sets. 
This chapter describes these requirements as well as SMF storage requirements and 
performance considerations. 



Including User-Written Exit Routines In The Operating System 

User-written exit routines are optional - SMF automatically provides dummy 
routines for all unused SMF exits. To include user-written exit routines in the 
operating system, you can add them to the appropriate distribution libraries before 
SYSGEN, or link-edit them into the required load modules in SYS1.LPALIB after 
SYSGEN. 

Figure 2 shows the distribution libraries to use to add exit routines prior to 
SYSGEN. It also shows the load module assignments to use to add exit routines 
after SYSGEN. When adding exit routines after SYSGEN, refer to your SYSGEN 
listing for exact load module names, aliases, link-edit control statements, and link- 
edit parameters. Specify link-edit parameters according to the characteristics of the 
user-written exit routines. 



Exit Routine 


Descriptive Name 


Distribution Library 
for Adding User- 
Written Exit Routine 
before SYSGEN 1 


Load Module Assignment 
for Adding User-Written Exit 
Routine to SYS1.LPALIB 
after SYSGEN 


IEFUJV 


Job Validation 


SYS1.AOSB3 


IEFUJV 


IEFUJI 


Job Initiation 


SYS1.AOSB3 


IEFSD060 


IEFUSI 


Step Initiation 


SYS1.AOSB3 


IEFSD060 


IEFUTL 


Time Limit 


SYS1.AOSB3 


IEFSD060 


IEFUSO 


SYSOUT Limit 


SYS 1. A LP A LIB 


IEFUSO 


IEFU83 


SMF Record 


SYS1.AOS00 


IEFU83 


IEFACTRT 


Termination 


SYS1.AOSB3 


IEFW21SD 


IEFUJP 


Job Purge 


SYS1.ALPALIB 


IEFUJP 


IEFU29 


SMF Dump 


SYS1.AOS00 


IEEMB829 



1 User-written exit routines to be added before SYSGEN must be in load module format. 
Figure 2. Including User-Written Exit Routines in the Operating System 

Note: If a user-written exit routine is link-edited into a load module of an active 
system, a link-edit failure might make that load module inoperative. This is 
particularly important in the case of termination exit routines that direct output to 
SYSOUT because the cause of failure would also be lost. 
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//LINKEXIT 


JOB 


//STEP1 


EXEC 


//SYSPRINT 


DD 


//SYSLMOD 


DD 


//SYSUT1 


DD 



Figure 3 shows sample JCL for adding user-written exit routines to 
SYS1.LPALIB after SYSGEN. Note that when user-written exit routines become 
part of SYS1 .LPALIB they do not become active until the next IPL of the system. 

Note: Refer to your SYSGEN listing for exact load module names, aliases, link- 
edit control statements, and link-edit parameters. Specify link-edit parameters 
according to the characteristics of the user-written exit routines. 

MSGLEVEL=1 

PGM=IEWL,PARM=7//t*-e</if parameters' 

SYSOUT=A 

DISP=(0LD,KEEP),DSN=SYS1.LPALIB 

UNIT=SYSDAJ)ISP=(,DELETE), 

SPACE=(TRK,(20,5)) 

//SYSLIN DD * 

(IEFUJV object deck) 

ENTRY IEFUJV 

NAME IEFUJV(R) 

(IEFACTRT object deck) 

ENTRY IEFBB401 

INCLUDE S YSLMOD(IEFW2 1 SD) 

ALIAS atiasnamel ,aliasname2, . . . 

NAME IEFW21SD(R) 

(IEFUJI, IEFUSI,and IEFUTL object decks) 

ENTRY IEFSD060 

INCLUDE SYSLMOD(IEFSD060) 

ALIAS aliasnamel ,aliasname2, . . . 

NAME IEFSD060(R) 

(IEFUSO object deck) 

ENTRY IEFUSO 

NAME IEFUSO(R) 

(IEFU83 object deck) 

ENTRY IEFU83 

NAME IEFU83(R) 

(IEFUJP object deck) 

ENTRY IEFUJP 

NAME IEFUJP(R) 

/* 

Figure 3. Sample JCL for Adding User-Written Exit Routines to SYS 1. LPALIB after SYSGEN 
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Storage Requirements 



SMF requires additional real storage in the pageable link pack area (PLPA), local 
system queue area (LSQA), system queue area (SQA), and common service area 
(CSA). SMF requires additional auxiliary storage for the SMF data sets and for 
user-written exit routines. Figure 4 summarizes the system areas that require 
additional storage for SMF and the amount of storage that is needed in each area. 



Item 


Additional Storage Required for SMF 


Area in System 


SMF Writer Routine 


1560 bytes 


Pageable Link Pack Area (PLPA) 


Timing Control Table (TCT) 
(one is created for each 
active job step) 


lfOPT=1, 116 bytes for each TCT 1 

If OPT=2, size of each 

TCT=132+12(a)+8(b) 1 

where: a is the maximum number of DD 
statements per job step. 

b is the number of devices 
allocated because of each DD 
statement. 


Fixed Local System Queue Area (LSQA) 


"System Management Control 
Area (SMC A) 


180 bytes 


Fixed System Queue Area (SQA) 


Common Exit Parameter Area 


36 bytes 


Fixed LSQA 


SMF Buffer 


400 to 8,192 bytes (See the following 
section, "SMF Buffer.") 


Pageable Common Service Area (CSA) 


SMF Data Sets 


(See "SMF Data Sets" later in this chapter.) 


DASD 


User-Written Exit Routines 


Size of all user-written exit routines 


SYS1.LPALIB 


Work Area for User-Written Exit 
Routines 


Size of user-requested area (See "Obtaining 
Additional Work Areas" in the chapter 
"User-Written Exit Routines") 


Pageable CSA, SQA and/or LSQA 



J When necessary, the dynamic allocation function will increase the TCT size in steps of 200 bytes. 
Figure 4. SMF Storage Requirements 

SMF Buffer 



If records are to be written to the SMF data set, you must supply a buffer size in 
the SMFPRMxx BUF parameter before or during IPL. (For detailed information on 
the BUF parameter, see "SMFPRMxx Parameters" in the chapter "Defining the Use 
of SMF".) The minimum SMF buffer "size is 400 bytes; the maximum is 8,192 bytes. 

The SMF buffer has two parts: while one half is being filled with SMF records, 
the other half is being written to the SMF data set. If a record size should exceed 
half of the buffer size, the record is segmented before it is written. In order to 
prevent segmenting records (and thereby improve performance), specify a buffer 
size that is at least twice the size of the largest record to be written to the SMF 
data set. 

Figure 5 summarizes the sizes of the SMF records. When calculating the largest 
record size, be sure to include the block descriptor word (four bytes) and the record 
descriptor word (four bytes). Do not make the buffer size larger than necessary; if 
the system should fail, the records in the SMF buffer will be lost. 
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Record Type 


Record Size (in bytes) 





31 


2 


14 


3 


14 


4 


147 + 8 per DD statement + length of step accounting fields 


5 


117 + length of job accounting fields 


6 


90 for JES2 writer/ 11 2 for JES3 writer/84 for external writer 


7 


24 


8 


16 + 4 per device 


9 


16 + 4 per device 


10 


40 + 4 per device 


11 


16 + 4 per device 


14 


264 + 24 per UCB + 28 per ISAM data set 


15 


264 + 24 per UCB + 28 per ISAM data set 


17 


88 + 8 per data set scratched 


18 


1 32 + 8 per data set renamed 


19 


64 


20 


61 + length of job accounting fields 


21 


44 


22 


18 + 42 at IPL + 6 per CPU, channel, storage range or device 




varied 


25 


88 


26 


232 for JES2/314 for JES3 


31 


54 


34 


147 + 8 per device + length of step accounting fields 


35 


117+ length of job accounting fields 


40 


62 + 8 per device 


43 


28 for JES2 / 38 for JES3 


45 


24 for JES2 / 26 for JES3 


47 


48 + 38 perSIGNON 


48 


71 for JES2/ 79 for JES3 


49 


86 


62 


138 + 10 per volume 


63 


132 + length of catalog records 


64 


250+ 26 per extent 


67 


130 + length of catalog records 


68 


170 


69 


102 


70 


52 + 16 per CPU 


71 


132 


72 


60 + 20 per performance group period 


73 


52+16 per channel 


74 


52 + 28 per device 



Figure 5. SMF Record Sizes ' 

Note: If you plan to reduce the SMF buffer size during consecutive IPL's, dump 
the SMF data sets first so that all records will be written with the same block size. 
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Storage Requirements 



SMF requires additional real storage in the pageable link pack area (PLPA). local 
system queue area (LSQA), system queue area (SQA), and common service area 
(CSA). SMF requires additional auxiliary storage for the SMF data sets and for 
user-written exit routines. Figure 4 summarizes the system areas that require 
additional storage for SMF and the amount of storage that is needed in each area 



Item 


Additional Storage Required for SMF 


Area in System 


SMF Writer Routine 


1560 bytes 


Pageable Link Pack Area (PLPA) 


Timing Control Table (TCT) 
(one is created for each 
active job step) 


I f OPT= 1 , 1 1 6 by tes f or each TCT x 

If OPT=2, size of each 

TCT=132+12(a)+8(b) 1 

where: a is the maximum number of DD 
statements per job step. 

b is the number of devices 
allocated because of each DD 
statement. 


Fixed Local System Queue Area (LSQA) 


Systecn Management Control 
Area (SMCA) 


180 bytes 


Fixed System Queue Area (SQA) 


Common Exit Parameter Area 


36 bytes 


Fixed LSQA 


SMF Buffer 


400 to 8,192 bytes (See the following 
section, "SMF Buffer.") 


Pageable Common Service Area (CSA) 


SMF Data Sets 


(See "SMF Data Sets" later in this chapter.) 


DASD 


User-Written Exit Routines 


Size of all user-written exit routines 


SYS1.LPALIB 


Work Area for User-Written Exit 
Routines 


Size of user-requested area (See "Obtaining 
Additional Work Areas" in the chapter 
"User-Written Exit Routines") 


Pageable CSA, SQA and/or LSQA 



1 When necessary, the dynamic allocation function will increase the TCT size in steps of 200 bytes. 
Figure 4. SMF Storage Requirements 

SMF Buffer 



If records are to be written to the SMF data set, you must supply a buffer size in 
the SMFPRMxx BUF parameter before or during IPL. (For detailed information on 
the BUF parameter, see "SMFPRMxx Parameters" in the chapter "Defining the Use 
of SMF".) The minimum SMF buffer size is 400 bytes; the maximum is 8,192 bytes. 

The SMF buffer has two parts: while one half is being filled with SMF records, 
the other half is being written to the SMF data set. If a record size should exceed 
half of the buffer size, the record is segmented before it is written. In order to 
prevent segmenting records (and thereby improve performance), specify a buffer 
size that is at least twice the size of the largest record to be written to the SMF 
data set. 

Figure 5 summarizes the sizes of the SMF records. When calculating the largest 
record size, be sure to include the block descriptor word (four bytes) and the record 
descriptor word (four bytes). Do not make the buffer size larger than necessary; if 
the system should fail, the records in the SMF buffer will be lost. 
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Record Type 


Record Size (in bytes) 





31 


2 


14 


3 


14 


4 


147 + 8 per DD statement + length of step accounting fields 


5 


117 + length of job accounting fields 


6 


90 for JES2 writer + 36 for 3800 fields / 1 12 for JES3 




writer + 36 for 3800 fields / 84 for external writer 


7 


24 


8 


16 + 4 per device 


9 


16 + 4 per device 


10 


40+4 per device 


11 


16 + 4 per device 


14 


264 + 24 per UCB + 28 per ISAM data set 


15 


264 + 24 per UCB + 28 per ISAM data set 


17 


88 + 8 per data set scratched 


18 


1 32 + 8 per data set renamed 


19 


64 


20 


61 + length of job accounting fields 


21 


44 


22 


18 + 42 at IPL + 6 per CPU, channel, storage range or device 




varied 


25 


88 


26 


232 for JES2/314 for JES3 


31 


54 


34 


147 + 8 per device + length of step accounting fields 


35 


117+ length of job accounting fields 


40 


62 + 8 per device 


43 


28 for JES2/38forJES3 


45 


24 for JES2/26 for JES3 


47 


48 + 38perSIGNON 


48 


71 for JES2/79 for JES3 


49 


48 + 38 per SIGNON 


62 


138+10 per volume 


63 


132 + length of catalog records 


64 


250+26 per extent 


67 


130 + length of catalog records 


68 


170 


69 


102 


70 


52 + 16 per CPU 


71 


132 


72 


60 + 20 per performance group period 


73 


52+16 per channel 


74 


52 + 28 per device 



Figure 5. SMF Record Sizes 

Note: If you plan to reduce the SMF buffer size during consecutive IPL's, dump 
the SMF data sets first so that all records will be written with the same block size. 
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SMF Data Sets 

You must allocate space for the SMF data sets, SYS1 .MANX and SYS1 .MANY, 
before IPL. Both data sets must be permanently resident on a direct access device. 
(Several factors, such as specific system configuration, amount of SMF data to be 
written, and report program requirements, will determine which device type is most 
efficient for a particular installation.) You must also catalog SYS1 .MANX and 
SYS1.MANY. 

Figure 6 illustrates sample DD statements for allocating the SMF data sets on 
direct access devices and cataloging them in the system catalog. Note that secondary 
space allocation is ignored. 

//MANX DD DSNAME=SYS1.MANX,UNIT=190,VOLUME=SER=111111, 
// SPACE=CrRK,(20)),DISP=(NEW,CATLG) 

//MANY DD DSNAME=SYS1.MANY,UNIT=191,VOLUME=SER=222222, 
// SPACE=(TRK,(20)),DISP=(NEW,CATLG) 

Figure 6. Sample DD Statements for Allocating and Cataloging the SMF Data Sets 



The amount of space to be allocated to SYS1 .MANX and SYS1 .MANY depends 
upon the amount of data generated by each job and how often the data sets are 
dumped. Figure 7 is an example of how to establish space requirements for an SMF 
data set, given certain assumptions. The values in Figure 7 are calculated for a four 
hour interval. Subsystem and MF/ 1 records are not shown in this example. 



SYSTEM-RELATED RECORDS 


Event or Status 


Record 
Type 


Assumption for This Example 


Example No. 

of Bytes per 

Record 


Example 
No. of 
Records 


Example 
Total No. 
of Bytes 


IPL 





Once per day 


31 


1 


31 


TIOC Initialization 


31 


Once per day 


54 


1 


54 


Devices Online at IPL 


8 


20 devices, including 6 DASD 


96 


1 


96 


19 


64 


6 


384 


22 


60 


1 


60 


End of Day 


19 


6 DASD 


64 


6 


384 


Devices Varied Online 


9 


Twice per hour 


20 


8 


160 


22 


1 MSS device per day 


24 


1 


24 


Device Recovered at Allocation 


10 


Once per hour 


44 


4 


176 


Devices Varied Offline 


11 


Twice per hour 


20 


8 


160 


22 


1 MSS device per day 


24 


1 


24 


TOTAL FOR SYSTEM-RELATED RECORDS 


38 


1553 



Figure 7. Sample Data Set Space Requirements (Part 1 of 2) 
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JOB-RELATED RECORDS 


Event or Status 


Record 
Type 


Assumption for This Example 


Example No. 

of Bytes per 

Record 


Example 
No. of 
Records 


Example 
Total No. 
of Bytes 


Job Processing 


5 


Accounting data 1 


129 


1 


129 


20 


73 


1 


73 


35 


129 


1 


129 


19 


Demount 2 DASD volumes 


64 


2 


128 


21 


1 EOV or CLOSE 


44 


1 


44 


Step Processing 


4 


4 DD statements per step, 
accounting data 1 , 3 steps per job 


191 


3 


573 


34 


191 


3 


573 


14 


1 EOV and 2 CLOSE per step, 
3 steps per job 


288 


9 


2592 


15 


1 EOV and 2 CLOSE per step, 
3 steps per job 


288 


9 


2592 


17 


Scratch non-VSAM data set in 
1 step per 12 jobs 2 


96 


1 


96 


18 


Rename non-VSAM data set in 
1 step per 12 jobs 2 


140 


1 


140 


62 


Open 2 components per step 


168 


2 


336 


63 


Define 1 non-VSAM entry per step 


300 


1 


300 


Define VSAM index cluster in 
1 step per 1 2 jobs 2 


280 cluster 
550 data set 
500 index 


3 


1330 


Alter each component of VSAM 
index cluster per step 


1 1 50 data set 
930 index 


2 


2080 


64 


1 EOV and 1 CLOSE per VSAM 
component 


328 


4 


1312 


67 


Delete non-VSAM entry per step 


300 


1 


300 


Delete VSAM index cluster in 
1 step per 24 jobs 2 


280 cluster 
630 data set 
530 index 


3 


1440 


68 


ALTER rename a VSAM component 
in 1 step per 48 jobs 2 


170 


1 


170 


69 


Define, extend or delete space on 
1 volume in 1 step per 48 jobs 2 


102 


1 


102 


SYSOUT Processing 


6 


JES2 writer, 3 steps per job 


90 


3 


270 


26 


Job purge 


232 


1 


232 


TOTAL FOR JOB-RELATED RECORDS PER JOB 


53 


14,868 


TOTAL FOR 12 JOBS PER HOUR FOR 4 HOURS 


2544 


713,664 


TOTAL FOR SYSTEM-RELATED AND JOB-RELATED RECORDS 


2582 


715,217 


Record Descriptor Word 


ALL 


N/A 


4 


2582 


10,328 


Block Descriptor Word 


N/A 


6 records per block 


4 


430 blocks 


1720 


TOTAL NUMBER OF BYTES FOR THIS EXAMPLE 


727,265 



1 Accounting data consists of two 5-byte items. 

2 The number of bytes for these events is calculated only once for the four-hour interval. 

Figure 7. Sample Data Set Space Requirements (Part 2 of 2) 
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Dumping The SMF Data Sets 



When either SYS1 .MANX or SYS1 .MANY becomes full, the SMF writer routine 
writes a message to the console requesting a dump. The operator should use the 
SMF dump program, IFASMFDP, to transfer a full SMF data set to another data 
set (usually on tape), and to reset the status of the dumped data set to empty so 
that it can be used again for recording data. 

Figure 8 shows sample JCL for executing the SMF dump program. The output 
is a non-temporary data set on a standard-labeled tape. The operator should record 
the volume serial number of the output data set so that other jobs can reference it. 

//DUMPX JOB MSGLEVEL=1 

//STEP1 EXEC PGM=IFASMFDP 

//DUMPIN DD DSN=SYS1.MAN< }-,DISP=OLD 



ft- 



//DUMPOUT DD DSN=SMFDATA,UNIT=tapeaddr, 

// DISP=(NEW,KEEP),LABEL=(,SL),VOL=SER=serial 

//SYSPRINT DD SYSOUT=A 

Note: Do not specify the DCB= keyword when executing the SMF dump program. 
Although RECFM=VBS for both the SMF data set and the output data set, the 
SMF dump program alternately changes from RECFM=VBS to RECFM=VB in 
order to dump segmented records by individual segments. (See Figure 29 for sample 
JCL describing the output data set SMFDATA.) 

Figure 8. Sample JCL for Executing the SMF Dump Program 

The SMF dump program uses the basic sequential access method (BSAM) to 
physically copy the input data set, DUMPIN, to the output data set, DUMPOUT. 
During the copy process, the dump program creates two SMF records and writes 
them to the output data set: a dump header (record type 2) at the beginning of the 
data set and a dump trailer (record type 3) at the end of the data set. 

The SMF dump program also writes messages, as required, to SYSOUT: 

• The operator must not dump a data set that is being filled. If the operator 
attempts to dump the active SMF data set, IFASMFDP returns a code of X'10' 
in register 1 5 and writes a message to the console notifying the operator of the 
error. In response, the operator must cancel the dump program and then invoke 
it again to dump the correct data set. 

o If IFASMFDP is unable to open either the input or output data set, it writes an 
error message indicating which data set was not successfully opened. 

• IFASMFDP determines whether the blocksize of the output data set is smaller 
than the blocksize of the input data set. If it is, IFASMFDP writes an error 
message to the console. 

• If both SMF data sets and the SMF buffer become full, SMF will be in a data lost 
condition (unable to record) until dumping takes place. When this condition 
occurs, the lost records are tracked in SMF record type 7 and the operator 
receives a message stating that he or she should dump either data set. 
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One method of executing the SMF dump program is to enter jobs that specify 
the program into the system, and hold them on the job queue until a dump is 
required. Another method is to start a reader to an input stream containing the 
JCL for the SMF dump program. Figure 9 illustrates two sample procedures 
(DUMPX and DUMPY) for dumping the SMF data sets to a standard-labeled tape 
(VOL=SER=SMFTAP) by means of the operator START command. In both 
procedures, the default tape specified on the PROC statement is 192. Figure 9 also 
illustrates sample JCL for adding these procedures to SYS1 .PROCLIB. 



//UPDATE 


JOB 


MSGLEVEL=1 


//UPDATE 


EXEC 


PGM=IEBUPDTE,PARM=NEW 


//SYSUT1 


DD 


DSN=SYS1 .PROCLIB, DISP=SHR 


//SYSUT2 


DD 


DSN=SYS1 .PROCLIB,DISP=SHR 


//SYSPRINT 


DD 


SYSOUT=A 


//SYS IN 


DD 


DATA 


./ 


ADD 


NAME=DUMPX,LIST=ALL 


//DUMPX 


PROC 


TAPE=192 


//SMFDMP 


EXEC 


PGM=IFASMFDP 


//DUMPIN 


DD 


DSNAME=SYS1 .MANX,DISP=OLD 


//DUMPOUT 


DD 


DSNAME=SMFDATA,UNIT=&TAPE,DISP=(MOD,KEEP), 


II 




LABEL=(,SL),VOL=SER=SMFTAP 


//SYSPRINT 


DD 


SYSOUT=A 


./ 


ADD 


NAME=DUMPY.LIST=ALL 


//DUMPY 


PROC 


TAPE=192 


//SMFDMP 


EXEC 


PGM=IFASMFDP 


//DUMPIN 


DD 


DSNAME=SYS1.MANY,DISP=OLD 


//DUMPOUT 


DD 


DSNAME=SMFDATA,UNIT=&TAPE,DISP=(MOD,KEEP), 


II 




LABEL=(,SL),VOL=SER=SMFTAP 


//SYSPRINT 


DD 


SYSOUT=A 


./ENDUP 
/• 







Figure 9. Sample Procedures for Dumping the SMF Data Sets 



Switching The SMF Data Sets 

When an SMF data set becomes full. SMF writes a message to the console and 
automatically switches recording from the active SMF data set to the inactive SMF 
data set. To prepare an SMF data set for dumping before it becomes full, however, 
the operator can use the HALT EOD and SWITCH SMF commands. (These 
operator commands are fully described in Operator's Library: OS/VS2 Reference 
I (JKS2J and Operator's Library: OS/VS2 Reference (JKS3). ) 

When the operator issues either the HALT EOD or the SWITCH SMF command, 
the following actions occur: 

• A type 19 record is created for each online direct access device if DSV=1 or 
DSV=3 was specified. 

• The SMF buffer is written to the SMF data set. 



The SMF data sets are switched so that the operator can dump the previously 
active data set. 



Note: When switching the SMF data sets, the inactive data set cannot become 
active unless it is empty. Therefore, the operator must dump the inactive data set 
(or initialize the system) before issuing the HALT or SWITCH command. 
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Dumping The SMF Data Sets 



When either SYS1 .MANX or SYS1 MANY becomes full, the SMF writer routine 
notifies the operator that the data set needs to be dumped, automatically switches 
recording from the active SMF data set to the inactive SMF data set, and then 
passes control to the SMF dump exit, IEFU29. (For information on the IEFU29 
exit, see the chapter "User-Written Exit Routines".) The operator should use the 
SMF dump program, IFASMFDP, to transfer a full SMF data set to another data 
set (usually on tape), and to reset the status of the dumped data set to empty so 
that it can be used again for recording data. 

Figure 8 shows sample JCL for executing the SMF dump program. The output 
is a non-temporary data set on a standard-labeled tape. The operator should record 
the volume serial number of the output data set so that other jobs can reference it. 

//DUMPX JOB MSGLEVEL=1 

//STEP1 EXEC PGM=IFASMFDP 



»•■ 



//DUMPIN DD DSN=SYS1.MAN< >,DISP=OLD 

//DUMPOUT DD DSN=SMFDATA,UNIT=tapeaddr, 

// DISP=(NEW,KEEP),LABEL=(,SL),VOL=SER=serial 

//SYSPRINT DD SYSOUT=A 

Note: Do not specify the DCB= keyword when executing the SMF dump program. 
Although RECFM=VBS for both the SMF data set and the output data set, the 
SMF dump program alternately changes from RECFM=VBS to RECFM=VB in 
order to dump segmented records by individual segments. (See Figure 29 for sample 
JCL describing the output data set SMFDATA.) 

Figure 8. Sample JCL for Executing the SMF Dump Program 

The SMF dump program uses the basic sequential access method (BSAM) to 
physically copy the input data set, DUMPIN, to the output data set, DUMPOUT. 
During the copy process, the dump program creates two SMF records and writes 
them to the output data set : a dump header (record type 2) at the beginning of the 
data set and a dump trailer (record type 3) at the end of the data set. 

The SMF dump program also writes messages, as required, to SYSOUT: 

• The operator must not dump a data set that is being filled. If the operator 
attempts to dump the active SMF data set, IFASMFDP returns a code of X'10' 
in register 1 5 and writes a message to the console notifying the operator of the 
error. In response, the operator must cancel the dump program and then invoke 
it again to dump the correct data set. 

• If IFASMFDP is unable to open either the input or output data set, it writes an 
error message indicating which data set was not successfully opened. 

• IFASMFDP determines whether the blocksize of the output data set is smaller 
than the blocksize of the input data set. If it is, IFASMFDP writes an error 
message to the console. 

• If both SMF data sets and the SMF buffer become full, SMF will be in a data lost 
condition (unable to record) until dumping takes place. When this condition 
occurs, the lost records are tracked in SMF record type 7 and the operator 
receives a message stating that he or she should dump either data set. 
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One method of executing the SMF dump program is to enter jobs that specify 
the program into the system, and hold them on the job queue until a dump is 
required. Another method is to start a reader to an input stream containing the 
JCL for the SMF dump program. Figure 9 illustrates two sample procedures 
(DUMPX and DUMPY) for dumping the SMF data sets to a standard-labeled tape 
(VOL=SER=SMFTAP) by means of the operator START command. In both 
procedures, the default tape specified on the PROC statement is 192. Figure 9 also 
illustrates sample JCL for adding these procedures to SYS1 .PROCLIB. 



//UPDATE 


JOB 


MSGLEVEL=1 


//UPDATE 


EXEC 


PGM=IEBUPDTE,PARM=NEW 


//SYSUT1 


DD 


DSN=SYS1 ,PROCLIB,DISP=SHR 


//SYSUT2 


DD 


DSN=SYS1 .PROCLIB,DISP=SHR 


//SYSPRINT 


DD 


SYSOUT=A 


//SYS IN 


DD 


DATA 


./ 


ADD 


NAME=DUMPX,LIST=ALL 


//DUMPX 


PROC 


TAPE=192 


//SMFDMP 


EXEC 


PGM=IFASMFDP 


//DUMPIN 


DD 


DSNAME=SYS1 .MANX,DISP=OLD 


//DUMPOUT 


DD 


DSNAME=SMFDATA,UNIT=&TAPE,DISP=(MOD,KEEP), 


II 




LABEL=(,SL),VOL=SER=SMFTAP 


//SYSPRINT 


DD 


SYSOUT=A 


./ 


ADD 


NAME=DUMPY,LIST=ALL 


//DUMPY 


PROC 


TAPE=192 


//SMFDMP 


EXEC 


PGMHFASMFDP 


//DUMPIN 


DD 


DSNAME=SYS1 .MANY,DISP=OLD 


//DUMPOUT 


DD 


DSNAME=SMFDATA,UNIT=&TAPE,DISP=(MOD,KEEP), 


II 




LABEL=(,SL),VOL=SER=SMFTAP 


//SYSPRINT 


DD 


SYSOUT=A 


./ENDUP 
/* 







Figure 9. Sample Procedures for Dumping the SMF Data Sets 



Switching the SMF Data Sets 

I 

To prepare an SMF data set for dumping before it becomes full the operator can 
use the HALT EOD and SWITCH SMF commands. (These operator commands 
are fully described in Operator's Library: OS/VS2 Reference (JES2). ) 

When the operator issues either the HALT EOD or the SWITCH SMF command, 
the following actions occur: 

• A type 19 record is created for each online direct access device if DSV=1 or 
DSV=3 was specified. 

• The SMF buffer is written to the SMF data set. 



The SMF data sets are switched so that the operator can dump the previously 
active data set. 



Note: When switching the SMF data sets, the inactive data set cannot become 
active unless it is empty. Therefore, the operator must dump the inactive data set 
(or initialize the system) before issuing the HALT or SWITCH command. 
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Performance Considerations 



SMF will reduce system throughput by various amounts depending upon factors 
such as : 

• SMF options selected through the SMFPRMxx parameters. (For a description 
of these parameters, see the chapter "Defining the Use of SMF".) 

• SMF buffer size. (If the buffer size is too small, SMF segments records before 
writing them.) 

• SMF data set size, device type, and dumping requirements. 

• Execution time of user-written exit routines. 

• System configuration, especially the type and degree of multiprogramming. 

• Processing characteristics, such as the number of jobs (the number of records 
generated by SMF is dependent on the number of jobs), the contention for SMF 
resources, and user data set requirements. 
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Defining The Use Of SMF 



An installation must define how it will be using SMF through a SYS1 .PARMLIB 
member SMFPRMxx: 

• Required SMFPRMxx parameters specify the job wait time limit and the system 
on which SMF is active. 

• Optional SMFPRMxx parameters allow an installation to select record types, to 
permit operator modification of SMF parameters, and to specify whether SMF 
exits are to be taken. 

You can specify SMFPRMxx parameters (1 ) before the first IPL of a newly 
generated system by adding SMFPRMxx as a member in SYS1 PARMLIB, or (2) at 
each initialization of SMF by entering the parameters at the console. 



SMFPRMxx Parameters 



The SMFPRMxx parameters are described in Figure 10. Note that the JWT and 
SID parameters are required for SMF. The BUF parameter is also required unless 
MAN=NONE is specified. 

Notes: 

1 . If a job is recovered in a warm start, the values for the DSV, EXT, OPT and 
REC parameters will be the values in effect when the job was read. Modifications 
for these parameters are ignored during a warm start IPL. The value for the SID 
parameter will be the value in effect when the job was read for record types 4, 5, 
34 and 35 only. 

2. To use the IEHUCAT utility program, specify: MAN=ALL, OPT=2, and DSV=2 
or 3. These parameters are required for IEHUCAT to update an OS catalog to 
the level of a VSAM catalog. (For more information about IEHUCAT, see 

OS/ VS Utilities.) 
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Parameter 


Meaning and Use 


Value Range 


Default Value 


BUF-r™ \ 
{ nnnn ) 


This parameter is required unless MAN=NONE is specified. It 
indicates the SMF buffer size. (SMF buffer size requirements 
are discussed in the chapter "System Requirements and 
Considerations.") 
Notes: 

1. Specify a BUF value that is a multiple of 8 bytes (double 
word); otherwise, SMF rounds the value to the next lower 
multiple of 8 bytes. 

2. Before reducing the buffer size specified in the previous 
IPL, dump the SMF data set; otherwise the data sets 
cannot be dumped. 


400 to 8,192 


None (Operator is 
prompted if BUF value is 
needed.) 


DSV=-J J \ 
(3) 


This optional parameter specifies whether data set information 
and/or direct access volume information is to be collected 
by SMF. 

suppresses both data set information and direct access 
volume information. 

1 generates direct access volume information and suppresses 
data set information. 

2 generates data set information and suppresses direct 
access volume information. 

3 generates both data set information and direct access 
volume information. 

Note: If OPT=1 and either DSV=2 or DSV=3 is specified, 
SMF converts OPT=1 into OPT=2 and issues a warning message. 


0, 1,2 or 3 





«"H3?I 


This optional parameter specifies whether SMF exits (except 
IEFUSO, which is always taken when the output limit is 
reached, and IEFU29, which is always taken when an SMF data 
set becomes full ) are to be taken. 

YES specifies exits are to be taken. 

NO specifies exits are not to be taken. 

Note: If EXT=YES is specified, the exits taken will depend 

upon the data-collection parameter, OPT. If OPT=2, all 

exits defined for the system are taken. If OPT=1 , the step 

initiation exit, IEFUSI, and the step termination exit, 

IEFACTRT, are not taken. 


Not applicable 


YES 


JWT=WJ/7 


This is a required parameter that initially specifies the number 
of minutes a job is allowed to wait continuously. When the 
specified time limit has expired, the time limit exit, IEFUTL, 
is entered (if exits are to be taken). The limit value can be 
changed by IEFUTL. 


1-999 


10 


/NONE) 

MAN=<USER > 

VALL ) 


This optional parameter specifies whether user and/or SMF 
records are to be written to the SMF data sets. You must 
specify MAN=ALL or MAN=USER if records are to be 
written to the SMF data sets. Unless MAN=NONE is 
specified, the BUF parameter is also required. 
NONE does not write user or SMF records to the SMF 

data sets, regardless of values specified for DSV, 

OPT, and REC parameters. 
USER writes only user records (types 128 through 255) 

to the SMF data sets. 
ALL writes both SMF and user records to the SMF data 

sets. All SMF records are created unless suppressed 

by the DSV, OPT, or REC parameters. All SMF 

records that are created are written unless suppressed 

by user-written exit routines. 

Note: Even if MAN=USER is specified, the SMF record types 
2, 3, and 7 will still be written. 


Not applicable 


ALL 



Figure 10. SMFPRMxx Parameters (Part 1 of 2) 
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Parameter 


Meaning and Use 


Value Range 


Default Value 


°-!^ s ( 


This optional parameter specifies whether the SMFPRMxx 
parameters are to be presented on the console during IPL for the 
operator's inspection and/or modification. (This parameter is 
ignored if it is entered from the console.) 
YES allows the operator to modify the SMFPRMxx 

parameters. 
NO does not allow the operator to modify the SMFPRMxx 

parameters. 


Not applicable 


NO 


™-\\\ 


This optional parameter specifies whether system and job informa- 
tion, as opposed to system, job, and job step information, is to 
be recorded. 

1 generates only system and job-related information (that is, 
record types 4 and 34 are suppressed and the step 
initiation exit, IEFUSI, and step termination exit, IEEACTRT, 
are not taken). 

2 generates system, job, and job step information. 

Notes: 

1 . For the system resource manager (SRM) to do I/O load 
balancing, specify OPT=2 so that SRM can access EXCP 
counts by job step. If OPT=1, I/O load balancing is non- 
operative. 

2. If OPT=1 and DSV=2 or DSV=3 is specified, SMF converts 
OPT=1 into OPT=2 and issues a warning message. 


1 or 2 


2 


"Ecjff 


This optional parameter specifies whether record type 1 7 will 
be written for temporary data sets. This parameter is not 
effective unless either DSV=2 or DSV=3 is specified. 
writes record type 1 7 for non-temporary data sets only. 
2 writes record type 1 7 for both temporary and non-temporary 
data sets. 


0or2 





SID=xxxx 


This is a required parameter that specifies the system and model 
on which SMF is active, provided the installation modifies the 
default value. 


Four alphameric 
and/or special 
characters 


H155 



Figure 10. SMFPRMxx Parameters (Part 2 of 2) 
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Selecting SMF Records Using SMFPRMxx Parameters 

Four SMFPRMxx parameters control the type of records to be written to the SMF 
data set: DSV, MAN, OPT, and REC. Figure 1 1 summarizes the use of these four 
parameters in selecting SMF records. 



Parameter 


Value 


Meaning 


Effect on SMF Records 


DSV 





No information for data sets or direct 
access volumes. 


Suppresses record types 14, 15, 17, 18, 19, 62, 63, 64, 67, 68, 
arid 69. 


1 


Direct access volume information. 1 


Generates record types 19 and 69; suppresses record types 14, 15, 
17, 18. 62, 63, 64, 67, and 68. 


2 


Data set information. 2 


Generates record types 14, f5, 17, 18, 62, 63, 64, 67, and 68; 
suppresses record types 19 and 69. 


3 


Data set and direct access 
information. 1,2 


Generates record types 14, 15, 17, 18, 19, 62, 63, 64, 67, 68, 
and 69. 


' MAN 


NONE 


No records. 


The SMF data set is not used. 


USER 


User records. 


User record types 128 through 255 (and SMF record types 2, 3, 
and 7) can be written to the SMF data set. 


ALL 


Both user and SMF records. 3 


Record types through 255 can be written to the SMF data set. 


OPT 


1 


System and job information. 


Generates record types 0, 2, 3, 5-1 1 , 20, 22, 25 ( JES3 only) , 26, 
31 , 35, 40, 43, 45, 47-49; suppresses record types 4 and 34. 


2 


System, job, and job step information. 


Generates record types 4, 34 and all the above record types. 


REC 





No information for temporary 
data sets. 


Generates record type 1 7 for non-temporary data sets only. 


2 


Temporary and non-temporary data 
set information. 


Generates record type 17 for both temporary and non-temporary 
data sets. 



1 Record type 21 is always written to the SMF data set by the error statistics by volume (ESV) routine. 

2 lf OPT=1 and either DSV=2 or DSV=3 is specified, SMF converts OPT=1 to OPT=2 and issues a warning message. 

3 MF/1 record types 70-74 can only be written when MAN=ALL is specified. These records are selected by the 
RECORD parameter for MF/1, as described in OS/VS2 System Programming Library: Initialization and Tuning Guide. 

Figure 11. Summary of the Use of SMFPRMxx Parameters to Select SMF Records 

User-written exit routines IEFU83 (SMF writer) and IEFACTRT (termination) 
can also control which records are to be written to the SMF data set. After 
inspecting an SMF record, these routines return a code to the system indicating 
whether the record is to be written to the SMF data set. 

Entering SMFPRMxx in SYS l.PARMLIB 

When you have determined which SMF parameters to use, place them in an 
SMFPRMxx member of SYS1 .PARMLIB. The two alphameric characters, 
represented by xx, are appended to SMFPRM to identify your SMFPRMxx member. 
If you do not specify an SMFPRMxx member (with system parameters, such as 
SMF=01 for member SMFPRM01, or with an alternate member, such as 
IEASYSxx), the default member SMFPRM00 is used. The parameters in 
SMFPRMOOare: 

OPT=2,EXT=YES,SID=H155,BUF=2000,JWT=10,OPI=YES,MAN=ALL 
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The SMFPRMxx parameters can be in any order; however, note the 
following coding restrictions: 

• Code each series of parameters in logical records no more than 80 bytes long. 

• Use columns 1-71 ; columns 72-80 are ignored. 

• Enter each parameter in the format: key word=value. 

• Do not use embedded blanks. 

• Separate consecutive parameters by commas. 

• Do not divide a parameter between consecutive records. 

• Indicate continuation by placing a comma after the last entry on a record, 
followed by a blank before column 72. 

To add the SMFPRMxx parameters as a member of SYS1.PARMLIB, use the 
IEBUPDTE utility program. Figure 12 illustrates sample JCL for using IEBUPDTE 
to enter SMFPRM01 into SYS1.PARMLIB. To change the default member, 
SMFPRMOO, or the installation-defined SMFPRMxx member, replace them with a 
new version by again executing IEBUPDTE. For information on the IEBUPDTE 
program, see OS/VS Utilities. 

//ENTER JOB MSGLEVEL=1 

// EXEC PGM=IEBUPDTE,PARM=NEW 

//SYSPRINTDD SYSOUT=A 

//SYSUT2 DD DSNAME=SYS1.PARMLIB,DISP=(OLD,KEEP) 1 

//SYS IN DD DATA 

./ ADD LIST=ALL,NAME=SMFPRM01,LEVEL=01,SOURCE=0 

(SMFPRM01 member) 
./ ENDUP 

/* 

1 To access SMFPRMOO on the distribution package before SYSGEN, use the 
SYS1.APARMLIB data set. 

Figure 12. Sample JCL for Entering SMFPRM01 into SYS1.PARMLIB Using IEBUPDTE 

If OPI=YES was specified, the operator can modify the SMFPRMxx parameter 
values from the console during system initialization. If parameter errors occur, the 
operator will be prompted for correct parameters regardless of the value specified 
for OPI. 
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User-Written Exit Routines 



SMF has exits in the control program that can link to user-written routines for 
monitoring jobs or job steps at various points in their processing cycles. An 
installation can use any or all of the SMF exits by including user-written exit 
routines in the appropriate distribution libraries before SYSGEN or in 
SYS1 .LPALIB after SYSGEN. SMF automatically provides dummy routines for all 
unused exits. (For detailed information on adding user-written exit routines, see 
"Including Exit Routines in the Operating System" in the chapter "System 
Requirements and Considerations".) 



Planning Exit Routines 



This section introduces the SMF exits. It briefly describes when each exit is called, 
the parameters passed to it. and the return codes required from it. 

Exit Routines and Their Characteristics 

SMF supplies eight exits, which can link to user-written exit routines, as follows: 

• The job validation exit (IEFUJV) receives control from the converter before 
each job control statement (or cataloged procedure) in the input stream is 
interpreted. This exit also receives control after all the JCL is converted and 
again after all the JCL is interpreted. It is not taken for JCL comment state- 
ments or for any statements for console-started tasks. A return code from this 
exit indicates whether processing of the job is to be continued. 

• The job initiation exit (IEFUJI) receives control from the initiator before a job 
on the input queue is selected for initiation. A return code from this exit 
indicates whether the job is to be started or canceled. 

• The step initiation exit (IEFUSI) receives control from the initiator before each 
job step is started (prior to allocation). A return code from this exit indicates 
whether the job step is to be started or the job is to be canceled. 

• The time limit exit (IEFUTL) receives control from the timer interruption 
handler when one of the following time limits expires: the job CPU time limit 
(from the JOB statement); the step CPU time limit (from the EXEC statement 

or the default from the job entry subsystem): or the continuous wait time limit for 
the job (from the SMFPRMxx JWT parameter). A return code from this exit 
indicates whether the job step is to be terminated or processing is to be 
continued with a new time limit. 

• The SYSOUT limit exit (IEFUSO) receives control from the job entry subsystem 
when the number of records written to an output data set exceeds the output limit 
for that data set. A return code from this exit indicates whether the job is to be 
terminated or processing is to be continued using a new limit. 

• The SMF record exit (IEFU83) receives control from the SVC 83 routine before 
each 'record is written to the SMF data set. A return code from this exit indicates 
whether the current SMF record is to be suppressed. 
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• The termination exit (IEFACTRT) receives control from the terminator on the 
normal or abnormal termination of each job step and job. A return code from 
this exit indicates whether the job is to be continued (for job steps only) or 
terminated, and whether the SMF termination records are to be written to the 
SMF data set. 

• The job purge exit (IEFUJP) receives control from the job entry subsystem when 
a job is ready to be purged from the system (that is, after the job has terminated 
and all SYSOUT output that pertains to the job has been written). A return code 
from this exit indicates whether the SMF job purge record is to be written to the 
SMF data set. 

Figure 13 summarizes when each SMF exit is called, the modules that call each 
user-written exit routine, the information passed to each exit (in addition to the 
common exit parameters, described in Figure 16), and the return from each exit to 
the control program. 



Module: 


At: 


Interfaces 
With: 


For User 
Exit: 


Parameters Passed : 


Type of Return: 


IEFVHEB 


Prescan in 
Converter 


directly 


IEFUJV (entry 
codes 0-8) 


JCL statement image, type 
of JCL statement. 


Continue or cancel. 


IEFVHF 


Converter 
Termination 


directly 


IEFUJV (entry 
code 16) 


IEFVHN 


Interpreter 
Termination 


directly 


IEFUJV (entry 
code 32) 


IEFSD060 


Job Initiation 


IEFSMFIE 


IEFUJI 


Programmer name, job 
priority, job accounting 
fields. 


Continue or cancel. 


IEFSD060 


Step Initiation 


IEFSMFIE 


IEFUSI 


Job step name, program 
name, step accounting 
fields. 


Continue or cancel. 


1 EAT L EXT 


Timer 
Expiration 


directly 


IEFUTL 


None. 


Continue with new time limit or 
cancel. 


HASPSSSM 1 
IATDMEB 2 


Output Limit 
Expiration 


directly 


IEFUSO 


None. 


Continue with new limit or cancel. 


IGC0008C 


SMF Buffer 
Time 


IEEMB830 


IEFU83 


SMF record to be written. 


Write or do not write record to SMF 
data set. 


IEFW21SD 


Job 
Termination 


IEFTB721 


IEFACTRT 


Job step name, programmer 
name, job CPU time, job 
accounting fields, step CPU 
time, step accounting fields, 
completion code, SMF 
termination record. 


Continue or cancel; write' or do not 
write record to SMF data set. 


IEFW21SD 


Step 
Termination 


IEFTB721 


IEFACTRT 


HASPACCT 1 
IATPURG 2 


Job Purge 


directly 1 
IATOSDR 2 


IEFUJP 


SMF job purge record. 


Write or do not write record to 
SMF data set. 



^These modules are for JES2 only. 
2 These modules are for JES3 only. 

I igure 13. lixit Routine Characteristics 
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User-Written Exit Routines 



SMF has exits in the control program that can link to user-written routines for 
monitoring jobs or job steps at various points in their processing cycles. An 
installation can use any or all of the SMF exits by including user-written exit 
routines in the appropriate distribution libraries before SYSGEN or in 
SYS1 .LPALIB after SYSGEN. SMF automatically provides dummy routines for all 
unused exits. (For detailed information on adding user-written exit routines, see 
"Including Exit Routines in the Operating System" in the chapter "System 
Requirements and Considerations".) 



Planning Exit Routines 



This section introduces the SMF exits. It briefly describes when each exit is called, 
the parameters passed to it, and the return codes required from it. 

Exit Routines and Their Characteristics 

| SMF supplies nine exits, which can link to user-written exit routines, as follows: 

• The job validation exit (IEFUJV) receives control from the converter before 
each job control statement (or cataloged procedure) in the input stream is 
interpreted. This exit also receives control after all the JCL is converted and 
again after all the JCL is interpreted. It is not taken for JCL comment state- 
ments or for any statements for console-started tasks. A return code from this 
exit indicates whether processing of the job is to be continued. 

• The job initiation exit (IEFUJI) receives control from the initiator before a job 
on the input queue is selected for initiation. A return code from this exit 
indicates whether the job is to be started or canceled. 

• The step initiation exit (IEFUSI) receives control from the initiator before each 
job step is started (prior to allocation). A return code from this exit indicates 
whether the job step is to be started or the job is to be canceled. 

• The time limit exit (IEFUTL) receives control from the timer interruption 
handler when one of the following time limits expires: the job CPU time limit 
(from the JOB statement); the step CPU time limit (from the EXEC statement 

or the default from the job entry subsystem); or the continuous wait time limit for 
the job (from the SMFPRMxx JWT parameter). A return code from this exit 
indicates whether the job step is to be terminated or processing is to be 
continued with a new time limit. 

• The SYSOUT limit exit (IEFUSO) receives control from the job entry subsystem 
when the number of records written to an output data set exceeds the output limit 
for that data set. A return code from this exit indicates whether the job is to be 
terminated or processing is to be continued using a new limit. 

• The SMF record exit (IEFU83) receives control from the SVC 83 routine before 
each record is written to the SMF data set. A return code from this exit indicates 
whether the current SMF record is to be suppressed. 
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• The termination exit (IEFACTRT) receives control from the terminator on the 
normal or abnormal termination of each job step and job . A return code from 
this exit indicates whether the job is to be continued (for job steps only) or 
terminated, and whether the SMF termination records are to be written to the 
SMF data set. 

• The job purge exit (IEFUJP) receives control from the job entry subsystem when 
a job is ready to be purged from the system (that is, after the job has terminated 
and all SYSOUT output that pertains to the job has been written). A return code 
from this exit indicates whether the SMF job purge record is to be written to the 
SMF data set. 

• The SMF dump exit (IEFU29) receives control from the SMF writer when an 
SMF data set becomes full. This exit does not return a code to the control 
program. 

Figure 13 summarizes when each SMF exit is called, the modules that call each 
user-written exit routine, the information passed to each exit (in addition to the 
common exit parameters, described in Figure 16), and the return from each exit to 
the control program. 



Module: 


At: 


Interfaces 
With: 


For User 
Exit: 


Parameters Passed : 


Type of Return: 


IEFVHEB 


Prescan in 
Converter 


directly 


IEFUJV (entry 
codes 0-8) 


JCL statement image, type 
of JCL statement. 


Continue or cancel. 


IEFVHF 


Converter 
Termination 


directly 


IEFUJV (entry 
code 16) 


IEFVHN 


Interpreter 
Termination 


directly 


IEFUJV (entry 
code 32) 


IEFSD060 


Job Initiation 


IEFSMFIE 


IEFUJI 


Programmer name, fob 
priority, job accounting 
fields. 


Continue or cancel. 


IEFSD060 


Step Initiation 


IEFSMFIE 


tEFUSI 


Job step name, program 
name, step accounting 
fields. 


Continue or cancel. 


IEATLEXT 


Timer 
Expiration 


directly 


IEFUTL 


None. 


Continue with new time limit or 
cancel. 


HASPSSSM 


Output Limit 
Expiration 


directly 


IEFUSO 


None. 


Continue with new limit or cancel. 


IGC0008C 


SMF Buffer 
Time 


IEEMB830 


IEFU83 


SMF record to be written. 


Write or do not write record to SMF 
data set. 


IEFW21SD 


Job 
Termination 


IEFTB721 


IEFACTRT 


Job step name, programmer 
name, job CPU time, job 
accounting fields, step CPU 
time, step accounting fields, 
completion code, SMF 
termination record. 


Continue or cancel; write'or do not 
write record to SMF data set. 


IEFW21SD 


Step 
Termination 


IEFTB721 


IEFACTRT 


HASPACCT 


Job Purge 


directly 


IEFUJP 


SMF job purge record. 


Write or do not write record to 
SMF data set. 


IEEMB829 


SMF Dump 
Time 


directly 


IEFU29 


SMF data set name. 


None. 



Figure 13. Exit Routine Characteristics 
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Sample Exit Routines in SYS1.ASAMPLIB 

Sample assembler language exit routines for some SMF exits are provided in the 
member SMFEXITS of SYS1.ASAMPLIB. Figure 14 shows sample JCL for 
obtaining a listing of these sample routines. 



//PRINT 


JOB 


MSGLEVEL=1 


II 


EXEC 


PGM-IEBPTPCH 


//SYSPRINT 


DD 


SYSOUT=A 


//SYSUT1 


DD 


DSNAME=SYS1.ASAMPLIB,DISP-(OLD,KEEP), 


II 




UNIT=xxxx,VOLUME=SER=xxxxxx 1 


//SYSUT2 


DD 


SYSOUT=A 


//SYS IN 


DD 


• 




PRINT 


TYPORG=PO,MAXNAME=1,MAXFLDS=1 




MEMBER 


NAME=SMFEXITS 




RECORD 


FIELDH80) 


/• 







1 The volume and unit parameters depend upon your installation's request. 
Figure 14. Sample JCL For Obtaining a Listing of Sample Exit Routines 

A summary of the sample exit routines in SYS1.ASAMPLIB follows: 

• IEFUJV - Sample routine checks the validity of a continued JOB statement 

and of values supplied for REGIQN, PRTY, TIME, and accounting 
parameters in the JOB statement. The routine uses characters 
from the account number to index a table that contains allowable 
values for these parameters. If any value is invalid, the sample 
IEFUJV routine terminates the job. 

• IEFUJI - Sample routine determines how long a job has been on the input 

job queue before it is initiated. It then writes this value and the 
job priority to the SMF data set as a user record. 

• IEFUSI - No sample provided. 

• IEFUTL - Sample routine terminates a job if either the job CPU time limit or 

the job step CPU time limit has been exceeded. If the continuous 
wait time limit for the job has been exceeded, the routine extends 
the limit twice; on the third entry for exceeding the continuous 
wait time limit, it cancels the job. Each time the routine is 
entered for exceeding tht continuous wait time limit, it writes a 
record describing the action taken to the SMF data set. 

• IEFUSO - No sample provided. 
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• IEFU83 - Sample routine determines whether the record to be written is an 

IPL record. If it is, the routine writes to the operator with a reply 
request for the record types to be written. If the record is not an 
IPL record, the return code depends upon the records currently 
requested. 

The sample IEFU83 routine has a special macro definition for 
"write to operator with reply" so that output normally directed to 
the operator is suppressed and a standard reply is assumed for 
testing with the TESTEXIT procedure. Remove this macro 
definition if you want the message printed at the console. The 
sample routine also has special macro definitions for "write to 
operator" and "wait", which generate no-op instructions. 

• IEFACTRT- Sample routine changes the SMF job termination and job step 

termination records (unless the job step is flushed) to user records, 
and attempts to write them to the SMF data set. If the data set 
is full, the routine writes a message to the console indicating that 
SMF records are being lost. At job termination, the routine writes 
a record containing the job name, programmer's name, and account 
number to the SYSOUT device. 



• IEFUJP - No sample provided. 

• IEFU29 — Sample routine issues a WTOR macro instruction requesting the 

operator to start a procedure to dump the full SMF data set. A 
sample dumping procedure is provided in SYS1.ASAMPLIB as 
member SMFDUMP. The SMFDllMP procedure uses the SMF 
dump program, IFASMFDP. This program dumps the full 
SMF data set, and resets the status of the dumped data set to 
empty so that it can be used again for recording data. 



Writing Exit Routines 



This section describes: 

• Exit routine restrictions and facilities, including information on communication 
among user-written exit routines; the common parameters passed to all routines; 
the SMFWTM macro instruction, which is used to write records to the SMF data 
set; and the IFASMFR macro instruction, which is used to symbolically address 
fields in the SMF records. 

• Exit routines, including a full description of the parameters passed to each 
routine and the required return codes. 
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Exit Routine Restrictions 

This section describes only the restrictions and conditions common to most user- 
written exit routines. For those restrictions and conditions that involve only one 
or two exit routines, see the specific routine(s) later in this chapter. 

Before writing an exit routine, note the following user-written exit routine 
restrictions and conditions: 

• The SMF exits are not taken for problem programs started from the console or 
for problem programs running in system keys. 

• All user-written exit routines must be reenterable. 

• All user-written exit routines receive control via a BALR instruction. The 
routines must save registers when they receive control and restore registers 
when they return control to the control program. Register 1 3 contains the 
address of the register save area; register 14 contains the return address; and 
register 15 contains the entry point address. 

• Figure 1 5 shows the storage protection key in which each user- writ ten exit 
routine receives control. 



Key 


Exit Routine 





lEFUJV (with entry code 32) 

lEFUJI 

lEFUSI 

lEFUTL 

IEFU83 

lEFACTRT 

IEFU29 


1 


lEFUJV (with entry codes 0-16) 

IEFUSO 

IEFUJP 



Figure 15. Storage Protection Keys 

• All user-written exit routines receive control with the system enabled for 
interrupts. 

• No user-written exit routines except lEFACTRT can write to the system output 
message data set. 

• Do not allocate installation-defined data sets to SYSOUT. 

• User-written exit routines entered for foreground jobs cannot write to 
installation-defined data sets. Routines entered for background jobs must 
write to installation data sets defined as follows: 

— A data set used by the exit routines lEFUJI, lEFUSI, lEFUTL and 
lEFACTRT requires a DD statement in the initiator cataloged procedure. 

— A data set used by the lEFUJV and IEFUJP exit routines requires a DD 
statement in the job entry subsystem cataloged procedure. 

— User-written exit routines IEFUSO, IEFU29, and IEFU83 cannot write to 
installation-defined data sets for background jobs. 
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• All user-written exit routines that issue a WTOR macro instruction should 
also specify the LONG=YES parameter in the WAIT macro instruction. 

• If you plan to use the TESTEXIT procedure for testing user-written exit 
routines, see "TESTEXIT Exit Routine Requirements" in the chapter "Testing 
Exit Routines." 

• If you plan to use the IBM OS/VS Sort/Merge Program Product, do not create 
user records smaller than the minimum length required by the program. (When 
using tape work devices, the minimum length this program can sort is 18 bytes. 
Otherwise, the minimum is one byte.) 



44 OS/VS2 System Management Facilities (SMF) (VS2.03.807) 



VS2.03.807 

Exit Routine Facilities 

This section describes the facilities common to most user-written exit routines. For 
more information on the facilities that are particular to a specific exit routine, see 
that routine later in this chapter. 

Common Exit Parameter Area 

When a user-written exit routine receives control, register 1 points to a list of four- 
byte addresses. The first entry in this list is common to all exit routines except 
| IEFU83 and IEFU29. The first entry points to a parameter area that is 36 bytes long. 

Figure 16 describes the format of the common exit parameter area. Note that 
the fields in this parameter area are filled chronologically ; therefore, not all fields 
are meaningful for all user-written exit routines. 

Description 

Job name 

Time, in hundredths of a second, reader recognized the JOB card for this job 

Date reader recognized the JOB card for the job, in the form 00YYDDDF 
where F is the sign 

System identification (taken from SID parameter 1 ) 

User identification. SMF places this data in all subsequent records for this job. 
This field is initialized to EBCDIC blanks when each job is read 2 

Number of the step being processed 

I ndicator of the SMF options selected by the user 

Bit Meaning When Set 

System and job accounting (OPT=1) 

1 System, job, and step accounting (OPT=2) 

2 User exits will be taken (EXT=YES) 

3 Data set accounting (DSV-2 or 3) 

4 Volume accounting (DSV=1 or 3) 

5 Reserved 

6 Type 17 records will be written for temporary data sets (REC=2) 

7 If 0, background job. If 1 , foreground job 

30 1 binary Restart indicator 

Bit Meaning When Set 

Step restart 

1 Checkpoint/restart 

2 Continue restart 

3 Reserved 

4 Warm start 
5-7 Reserved 

31 1 EBCDIC Job class 

32 4 binary User-communication field. This field is intended for communication among user- 

written exit routines. It is initialized to zeros when the job entry subsystem is started 2 

Modifications for the SID parameter are ignored during a warm start IPL for SMF record types 4, 5, 34 and 35. 
2 These fields are provided for user modification. 

Figure 16. Common Exit Parameter Area 



Displacement 
from Pointer 


Field 
Size 


Data 
Format 





8 


EBCDIC 


8 


4 


binary 


12 


4 


packed 


16 


4 


EBCDIC 


20 


8 


EBCDIC 


28 


1 


binary 


29 


1 


binary 
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Communicating between Exit Routines 

User-written exit routines can communicate with each other in two ways: oy using 
the user-communication field or by using the user-identification field. Both of these 
fields are contained in the common exit parameter area, which is passed to all user- 
written exit routines except IEFU83 and IEFU29. 

All exit routines (except IEFU83 and IEFU29) that are executing within the 
same job can communicate via the user-communication field (displacement 32 in 
Figure 16) and the user-identification field (displacement 20 in Figure 16). The 
IEFUJV exit routine with entry code 1 is the only routine that carl communicate 
between different jobs; it must use the user-communication field to do so. 

Note: The user-communication field is initialized to zeros each time the job entry 
subsystem is started; the user-identification field is initialized to EBCDIC blanks 
each time a job is read. Neither of these fields is maintained if the system is restarted. 

Obtaining Additional Work Areas 

Any user-written exit routine can obtain an additional work area by issuing a 
GETMAIN macro instruction that specifies an appropriate subpool. Figure 17 
shows the subpools (and their characteristics) that are required to obtain additional 
work areas. Be sure to consider the storage required by an additional work area 
when estimating the sizes of the common service area (CSA), system queue area 
(SQA), and local system queue area (LSQA). 
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Subpool 
Number 


Area in 
Storage 


Attributes of Subpool 


Notes 


231 


CSA 


Explicitly freed 
Pageable 
Fetch-protected 
System-oriented 
User Key 


Because subpool 231 is fetch- 
protected, use it for exit 
communication only among exits of 
the same key (see Figure 15). 


241 


CSA 


Explicitly freed 

Pageable 

Not fetch-protected 

System-oriented 

User key 


Because SMF exit routines receive 
control in different keys (see 
Figure .15), and subpool 241 is not 
fetch- protected, use it for read 
access from all exits. 


245 


SQA 


Explicitly freed 

Fixed 

Not fetch-protected 

System-oriented 

Key=0 


Allows a task running in key to 
acquire non-accountable, fixed, 
protected storage that is system- 
oriented. 


253 


LSQA 
(task- 
related) 


Automatically freed at end 

of task 
Fixed 

Not fetch-protected 
Job-oriented 
Key=0 
Swappable 


Allows a task running in key to 
acquire fixed, accountable, 
protected storage in the LSQA for 
the user's region that is job-oriented 
and freed when the task terminates. 


254 


LSQA 
(step- 
related) 


Automatically freed at end 

of step 
Fixed 

Not fetch-protected 
Job-oriented 
Key=0 
Swappable 


Allows a task running in key to 
acquire fixed, accountable, 
protected storage in the LSQA for 
the user's region that is job-oriented 
and freed when the job step 
terminates. 


255 


LSQA 


Explicitly freed 

Fixed 

Not fetch-protected 

Job-oriented 

Key=0 

Swappable 


Allows a task running in key to 
acquire fixed, non-accountable, 
protected storage in the LSQA that 
is job-oriented and must be 
explicitly freed. 



Figure 17. Required Subpools for Obtaining Additional Work Areas 



If desired, you can place the address of the work area in the user-communication 
field. However, be aware that the address will be destroyed if the field is re-initial- 
ized to zeros because the job entry subsystem was started. 



Using the SMFWTM Macro to Write Records 

Use the SMFWTM macro instruction to write records to the SMF data set. You 
can use this macro in any exit routine that has a storage protect key of zero except 
I IEFU83 and IEFU29 (see Figure 15), and in any "exit routine that has an APF 
authorization. The SMFWTM macro is written in assembler language and is 
supplied on SYS1.MACLIB. Its format is: 



[label] SMFWTM j record address \ (r)\ 
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where: 

record address 

is the symbolic address of the record to be written. 

(r) 

is a register containing the address of the record to be written. The value 

for (r) can be either the absolute register number or a symbol for the 
register. In either case, you must code the parentheses, for example, (2) or 
(REG2). 

Record types 128 through 255 are available for user-written records. When using 
the SMFWTM macro instruction to write user records, you must include the standard 
SMF record header and a record descriptor word (RDW) for each record. (For a 
description of the standard SMF record header, see the chapter "SMF Records" in 
this book. For a description of the RDW, see OS/VS Data Management Services 
Guide.) 

Record types through 1 27 are SMF-formatted records. For all SMF-formatted 
records except types 4, 5, 34 and 35, you must supply only the record type field in 
the standard SMF record header (offset 1 in Figure 30). The SMFWTM macro 
supplies the remaining header information. 

The SMFWTM macro instruction returns a code in register 15 that indicates the 
record's status, as follows: 

• indicates the record was written without error. 

• 4 indicates the record was truncated because it would not completely fit in an 

empty SMF data set. 

• 8 indicates the record was not written because the length specified in the RDW 

was less than 1 8 bytes. 

• 16 indicates the record was not written because (1) the MAN=NONE parameter 

suppressed the writing of records to the SMF data set, or (2) the writing of 
records was allowed but the SMF data set was full. (If the SMF data set is 
full, the operator must dump it before additional SMF records can be written. 
See "Dumping the SMF Data Sets" in the chapter "System Requirements 
and Considerations" for the procedure for executing the SMF dump pro- 
gram. Also see the description of the "IEFU29 — SMF Dump Exit" in this 
chapter.) 

• 20 indicates the record was not written because the user-written IEFU83 exit 

routine suppressed the record. 

Using the IFASMFR Macro to Address SMF Record Fields 

Use the IFASMFR macro instruction in user-written exit routines (or in any problem 
program application) to symbolically address SMF record fields. The macro is 
written in assembler language and is supplied on SYS1.AMODGEN. (Depending on 
your installation's requirements, you may want to copy the IFASMFR macro from 
SYS1.AMODGEN into your own macro library or SYS1.MACLIB. Note that the 
IFASMFR macro is distributed as 14 submacros: IFASMFR, IFASMFR1 , 
IFASMFR2,... IFASMFR9, IFASMFRA,... IFASMFRD.) 
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The format of the IFASMFR macro is 



[label] IFASMFR n 



where: 

n 

is the record type to be defined. You must specify at least one record type 
with the macro; if more than one record type is specified, you must enclose 
'the record types in parentheses and separate them by commas. The values 
for n can be: 0, 2-1 1 , 14, 15, 17-22, 25 (JES3 only), 26, 31 . 34, 35, 
40,43,45,47-49,62-64,67-74. 

Notes: 

1 . The "Name" column in all the SMF record formats (see the chapter "SMF 
Records") contains the symbolic addresses defined by the IFASMFR macro 
instruction. 

2. Do not specify both record type 14 and record type 15 in the same program. 
Because these records are identical, whenever record type 1 5 is specified in the 
IFASMFR macro, record type 14 is defined. 

3. If you do not want the IFASMFR macro to use part of the problem program's 
storage, then supply a CSECT or DSECT statement ahead of the macro 
instruction. 



IEFUJV - Job Validation Exit 

IEFUJV receives control from the converter before each job control statement (or 
cataloged procedure) in the input stream is interpreted. This exit routine also 
receives control after all of the JCL is converted and again after all the JCL is 
interpreted. It is not taken for comment statements or for any statements for 
console-started tasks. A user-written IEFUJV exit routine can do any or all of the 
following: 

• Validate any account fields included in the JOB and EXEC statements by 
comparison with a standard list. 

• Validate or assign the REGION request. 

• Validate or assign job time and job step time parameters. 

• Control output stream data by using the OUTLIM or SPACE parameters. 

• Check for authorization to use data sets. 

• Create user-written records. 

• Assign the user identification to be included in the SMF termination records and 
the SMF SYSOUT records for the job. 
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Notes: 

1. If a cataloged procedure is used, it is expanded before the IEFUJV exit routine 
receives control; the sequence of statements is JOB, EXEC PROC=. . . , 
EXEC PGM=. . . , followed by the other statements of the procedure. Override 
statements immediately precede the statements being overriden. Note, however, 
that symbolic parameters are resolved after the IEFUJV exit routine is taken. 

2. When modifying a JCL statement, do not include additional JCL statements or 
continuation cards. Also, when adding or modifying operand fields, begin the 
first operand field in the same place that it was before any additions or 
modifications were made. 

3. Depending upon the processing to be performed, it may be more efficient to 
check JOB and EXEC statement accounting fields in the IEFUJI exit routine and 
the first IEFUSI exit routine, respectively. The accounting fields are passed as 
parameters to IEFUJI and IEFUSI, making a statement scan routine unnecessary. 
Either of these exit routines can assign user identification, and the IEFACTRT 
exit routine can write messages to the system output message data set. 

4. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the job entry subsystem cataloged procedure. 

5. When running JES2, you can use the job statement accounting field scan exit, 
HASPRSCN, as well as the IEFUJV exit. The HASPRSCN exit interprets any 
variables in the JOB card accounting field, and sets the appropriate fields in 
JES2 control blocks representing these variables. Because the HASPRSCN exit 
receives control before the IEFUJV exit, do not use the IEFUJV exit to change 
the following fields of the JOB card: CLASS, MSGLEVEL, NOTIFY, PRTY, 
and TYPRUN. For more information about the HASPRSCN exit, see OS/VS2 
System Programming Library : Job Management. 

6. A user-written IEFUJV exit routine (with entry code 1) can use the user- 
communication field to communicate between different jobs. Data placed in 
this field by IEFUJV will become part of each job, will be accessible by all exit 
routines entered during each job (except IEFU83), and will be the same the next 
time IEFUJV is entered unless the job entry subsystem is started. (When the job 
entry subsystem is started, the user-communication field is initialized to zeros.) 

7. For jobs canceled by IEFUJV, only SMF record types 6 and 26 are generated. 

Parameters 

At entry to the IEFUJV exit routine, register 1 points to a list of four-byte addresses, 
as follows : 

1 . The address of the common exit parameter area. (See Figure 16.) 

2. The address of an 80-character JCL statement image (in EBCDIC). (JCL 
statements are identical to those listed in the SYSOUT data set; control 
statements containing only comments, however, are not made available to this 
exit routine.) 

3. The address of a one-byte area that indicates the type of JCL statement being 
passed to this exit routine. The indicator will be a binary value, as follows: 

indicates a null statement. 

1 indicates a JOB statement. 

2 indicates an EXEC statement. 
4 indicates a DD statement. 

8 indicates a PROC statement (for symbolic parameter definition). 

16 indicates all JCL has been converted. 

32 indicates all JCL has been interpreted and all JCL has been passed to IEFUJV. 
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Return Codes 

Before the IEFUJV exit routine returns to the control program, it must place a 
return code in register 15, as follows: 

indicates job processing should be continued. 

4 indicates job processing should be canceled. 

IEFUJI - Job Initiation Exit 

IEFUJI receives control from the initiator when a job on the input queue is 
selected for initiation. A user-written IEFUJI exit routine can validate job 
accounting information or write to a user data set. It can also determine how 
long a job was on the input job queue before it was selected for initiation. 

Notes: 

1 . If an installation uses major and minor account numbers with several fields, this 
exit routine is easier to use than IEFUJV for account number processing because 
the accounting fields are placed in a formatted list. Figure 18 shows the format 
of the JOB statement accounting information that is available to IEFUJI. 

Offsets 
Dec. Hex. Length Format Description 

1 binary Number of accounting fields. 

1 1 variable EBCDIC Accounting fields. Each entry for an accounting 

field contains the length of the field (one byte, 
binary) followed by the field (EBCDIC). A zero 
indicates an omitted field. 

Figure 18. Format of Accounting Information Passed to IEFUJI, IEFUSI, IEFACTRT, 
and IEFUJP 

2. At job step or job termination, use the termination indicators in record types 4, 
5, 34 and 35 to determine whether IEFUJI canceled the job. 

3. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the initiator cataloged procedure. 

Parameters 

At entry to the IEFUJI exit routine, register 1 points to a list of four-byte addresses 
as follows: 

1. The address of the common exit parameter area. (See Figure 16.) 

2. The address of a 20-byte area containing the programmer's name (in EBCDIC) 
from the JOB statement. This area is aligned left and padded with blanks if 
necessary. 

3. The address of a one-byte area indicating the requested job priority. 

4. The address of an area containing the accounting information from the JOB 
statement. (See Figure 18.) 
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Return Codes 

Before the IEFUJI exit routine returns control to the control program, it must place 
a return code in register 15, as follows: 

indicates job processing should be continued. 
4 indicates job processing should be canceled. 

IEFUSI - Step Initiation Exit 

IEFUSI receives control from the initiator before each job step is started (prior to 
allocation). A user-written IEFUSI exit routine can validate job step accounting 
information or write to a user data set. 

Notes: 

1. If OPT=l was specified in the SMFPRMxx member or entered from the 
console at IPL time, this exit routine is not taken. 

2. If an installation uses major and minor account numbers with several fields, this 
exit routine is easier to use than IEFUJV for account number processing because 
the accounting fields are placed in a formatted list. Figure 18 shows the format 
of the EXEC statement accounting information that is available to IEFUSI. 

3. At job or job step termination, use the termination indicators in record types 4, 
5, 34 and 35 to determine whether IEFUSI canceled the job. 

4. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the initiator cataloged procedure. 

Parameters 

At entry to the IEFUSI exit routine, register 1 points to a list of four-byte addresses, 
as follows: 

1. The address of the common exit parameter area. (See Figure 16.) 

2. The address of an eight-byte area containing the job step name (in EBCDIC) 
from the EXEC statement. This area is aligned left and padded with blanks if 
necessary. 

3. The address of an eight-byte area containing the program name (in EBCDIC) 
from the EXEC statement. This area is aligned left and padded with blanks if 
necessary. 

4. The address of an area containing the accounting information from the EXEC 
statement. (See Figure 18.) 

Return Codes 

Before the IEFUSI exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 

indicates job processing should be continued. 
4 indicates job processing should be canceled. 
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IEFUTL - Time Limit Exit 

IEFUTL receives control from the timer interruption handler when one of the 
following time limits expires: 

• The job CPU time limit (from the JOB statement). 

• The step CPU time limit (from the EXEC statement or the default from the job 
entry subsystem). 

• The continuous wait time limit for the job (from the SMFPRMxx JWT parameter). 

A user-written IEFUTL exit routine can control and record time expirations. 
For example, it can inform the operator that a job has exceeded its continuous 
wait time limit and request a reply to either cancel the job or extend the time limit. 

Notes: 

1 . A system interlock occurs anytime IEFUTL enqueues on a resource already 
enqueued on by the job step task or any of its subtasks. (More specifically, the 
initiator abnormally terminates if IEFUTL enqueues on such a resource because 
the asynchronous exit interface routine sets a "step must complete" status 
before IEFUTL receives control.) The enqueue can come from within SVCs; 
for example, it can come from the SMFWTM and WTO macro instructions. To 
minimize the chances of an interlock, issue an ENQ macro of the following 
format before issuing an SMFWTM or WTO macro instruction: 

ENQ(QNAME,RNAME,M,3,SYSTEM),RET=TEST 

2. A user-written IEFUTL exit routine should control the number of extensions 
for a given step to prevent looping. It can record the expiration in the SMF 
data set or write a message to the console, however, in doing so, a system 
interlock could occur. (See Note 1.) To record the expiration in installation- 
defined data sets, you must define the data sets with a DD statement in the 
initiator cataloged procedure. 

3. CPU time is collected in two categories: execution under TCBs and execution 
under SRBs. The limiting function and the IEFUTL exit interfaces apply 
only to TCB time. 

4. If TIME=1440 is specified on the JOB statement, all TCB timing for the job is 
eliminated. If TIME=1440 is specified on the EXEC statement and a job time 
limit is not specified on the JOB statement, all TCB timing for the job step is 
eliminated. SRB time is always collected (even if TIME=1 440 is specified). 

5. If a job time limit is not specified on the JOB statement, the time limit for each 
job step is the value specified for the TIME= parameter on the EXEC statement, 
or the default value from the job entry subsystem. 

If a job time limit is specified on the JOB statement, the time limit for each job 
step is the remaining job time or the job step time limit (from the TIME= 
parameter or the job entry subsystem default), whichever is smaller. 
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You can extend execution time only within a step. Each extension resets the 
limit for the entire step to the extension value. If the step does not use all of 
the extended execution time, the time is not carried over for the next step. 

20 
The smallest time extension granted is 2 microseconds or 1.048576 seconds. 

90 

The CPU time-used field is checked each 10x2 microseconds (10.48576 
seconds) to see if the specified time limit has been exceeded. The actual time 
used may differ from the value in the time-used field because the field is not 
updated continuously. Thus, Ihe specified time limit may be exceeded by a 
value between zero and 10x2 microseconds. 
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Parameters 

At entry to the IEFUTL exit routine, register 1 points to the four-byte address of 
the common exit parameter area. (See Figure 16.) Register will have a binary 
value, as follows: 

indicates the job CPU time limit expired. 

4 indicates the step CPU time limit expired. 

8 indicates the continuous wait time limit for the job expired. 

Return Codes 

Before the IEFUTL exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 

indicates job processing is to be canceled. 

4 indicates job processing is to be continued with a time extension in timer units. 
8 indicates job processing is to be continued with a time extension in seconds. 

You must place the time extension in register 1 ; you can determine the number 
of timer units by the algorithm : 

1 second = 38400 timer units. 

IEFUSO - SYSOUT Limit Exit 

IEFUSO receives control from the job entry subsystem when the number of records 
written to an output data set exceeds the output limit for that data set. Unless an 
IEFUSO exit routine is supplied, jobs are canceled when the output limit is reached. 
To specify the output limit, use the OUTLIM parameter on the DD statement 
defining the output data set. Note that the OUTLIM parameter limits output only to 
spooled data sets. This parameter is described in OS/VS2 JCL Reference. 

Notes: 

1 . The IEFUSO exit routine is not controlled by the SMFPRMxx EXT parameter; 
if an IEFUSO exit routine is supplied, it will always receive control when the 
output limit for a data set having an OUTLIM value is reached. Otherwise, the 
job is canceled. 

2. If IEFUSO indicates that the output limit is to be increased (register 15=4) but 
you do not increase the limit (register 1=0), the exit routine will receive 
control again when the next record is written to the output data set. 

3. The IEFUSO exit routine cannot access installation-defined data sets. 
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Parameters 

At entry to the IEFUSO exit routine, register 1 points to the four-byte address of 
the common exit parameter area. (See Figure 16.) 

Return Codes 

Before the IEFUSO exit routine return's control to the control program, it must 
place a return code in register 1 5, as follows: 

indicates job step processing is to be canceled. 

4 indicates job step processing is to be continued and the output limit is to be 
increased by the value placed in register 1 . 

IEFU83 - SMF Record Exit 

IEFU83 receives control from the SVC 83 routine before each record is written to 
the SMF data set. This exit routine is not taken for records whose writing has been 
suppressed either because of a'system failure, or because of options selected at IPL 
time (see "Selecting SMF Records Using SMFPRMxx Parameters" in the chapter 
"Defining the Use of SMF"). A user-written IEFU83 exit routine can select the 
records to be written to the SMF data set or check the circumstances that caused 
SMF to generate a given record. An example of the latter is asking the operator the 
reason for an IPL when SMF generates an IPL record. (IEFU83 can also direct 
output to the console.) 

Notes: 

1 . The IEFU83 exit routine cannot access installation-defined data sets. Also, it 
cannot use the SMFWTM macro instruction to write to the SMF data set. 

2. If the installation does not plan to use record types 63 (VSAM Entry Defined) 
or 67 (VSAM Entry Deleted), you can use IEFU83 to suppress writing them to 
the SMF data set or to truncate them. 

3. The addresses of the user-communication and user-identification fields of the 
common exit parameter area are not passed to the IEFU83 exit routine. 

Parameters 

At entry to the IEFU83 exit routine, register 1 points to the four-byte address of 
the record descriptor word (RDW) of the SMF record to be written. 

Return Codes 

Before the IEFU83 exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 

indicates the record is to be written to the SMF data set. 

4 indicates the record is not to be written to the SMF data set. 
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IEFACTRT - Termination Exit 

IEFACTRT receives control from the terminator when each job or job step normally 
or abnormally terminates. If OPT=l was specified in the SMFPRMxx member of 
SYS1.PARMLIB or the operator entered OPT=l from the console at system 
initialization time, this exit routine receives control only at job termination. A user- 
written IEFACTRT exit routine can perform various functions that are unique to an 
installation's requirements. For example, it can change the SMF record types 4 and 
5 to user records and write them to an installation-defined data set for further 
analysis. 

Notes: 

1 . IEFACTRT is the only exit routine than can write to the system output message 
data set, and only by passing a message to module IEFYS. If a user-written 
IEFACTRT exit routine writes messages for system output, the contents of 
register 12 must be the same as when the routine received control, and register 13 
must contain the address of an 18-word work area. Figure 19 shows the procedure 
to use when writing system output messages from IEFACTRT. Note that the 
maximum number of characters printed on one line is 132. 



MSGADDR 
MSG 

MSGLEN 
VIEFYS 


MVC 
MVC 
L 
BALR 

DC 
DC 
DC 
DC 


36(4,12) ,MSGADDR 
42(2,1 2) .MSGLEN 
REG15,VIEFYS 
REG14JREG15 

A(MSG) 
C'message text' 
H'xx' 
V(IEFYS) 


MOVE MESSAGE ADDRESS AND 
LENGTH TO SYSTEM TABLE 
BRANCH AND LINK TO MESSAGE 
ROUTINE 

MESSAGE LENGTH 1 



1 The message will be truncated to 132 characters if necessary. 
Figure 19. Writing System Output Messages from IEFACTRT 

2. IEFACTRT can direct output to the console or to the system output device. It 
can also write to the SMF data set or to an installation-defined data set. To use 
installation-defined data sets with this exit routine, you must define them with 
a DD statement in the initiator cataloged procedure. 

3. At job step or job termination, use the termination indicators in record types 4 
and 5, respectively, to determine whether IEFACTRT canceled the job. 

Parameters 

At entry to the IEFACTRT exit routine, register 1 points to a list of four-byte 
addresses, as follows: 

1. The address of the common exit parameter area. (See Figure 16.) 

2. The address of an eight-byte area containing the job step name (in EBCDIC). 
This area is aligned left and padded with blanks if necessary. At job termination, 
the address is zero. 

3. The address of a 20-byte area containing the programmer's name (in EBCDIC). 
This area is aligned left and padded with blanks if necessary. 
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4. The address of a four-byte area whose first three bytes contain the job CPU time 
under TCBs, in hundredths of a second (in binary), and whose last byte contains 
the number of accounting fields in the JOB statement (in binary). 

5. The address of an area that contains accounting information from the JOB 
statement. This area has the format described earlier in Figure 18, excluding the 
first field shown (the number of accounting fields). 

6. The address of a four-byte area whose first three bytes contain the step CPU time 
under TCBs, in hundredths of a second (in binary), and whose last byte contains 
the number of accounting fields in the EXEC statement (in binary). At job 
termination, the address is zero. 

7. The address of an area that contains accounting information from the EXEC 
statement. This area has the format described earlier in Figure 18, excluding the 
first field shown (the number of accounting fields). At job termination, the 
address is zero. 

8. The address of a two-byte area. The first byte is an indicator: if bit 7 is set to 1 
when the exit routine is entered, the job has been canceled; if the exit routine 
sets bit 7 to 1 , the job will be canceled. The second byte contains the number of 
the job step currently being processed. At job termination, the second byte 
contains the number of steps in the job. 

9. The address of a two-byte area containing the termination status (condition or 
completion code) of the job or job step. 

10. The address of an area containing a four-byte record descriptor word (RDW) 
immediately followed by the job step termination record (type 4 or 34) or the 
job termination record (type 5 or 35) to be written to the SMF data set. 

At entry to the IEFACTRT exit routine, register contains a binary code 
indicating the reason for entry, as follows: 

12 indicates job step termination. 
1 6 indicates j ob termination. 

Return Codes 

Before the IEFACTRT exit routine returns control to the control program, it must 
place return codes in registers 1 and 15, as follows: 

• In register 1 : 

4 indicates the termination record is not to be written to the 

SMF data set. 
A value other than 4 indicates the termination record is to be written to the 

SMF data set. 

• In register 15: 

4 indicates the remaining job steps are to be canceled. 

A value other than 4 indicates job processing is to be continued. 
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IEFUJP - Job Purge Exit 

IEFUJP receives control from the job entry subsystem when a job is ready to be 
purged from the system, that is, after a job has terminated and all the SYSOUT 
output that pertains to the job has been written. A user-written IEFUJP exit 
routine can summarize a job's activities in the system. 

Note: To use installation-defined data sets with this exit routine, you must 
define them with a DD statement in the job entry subsystem cataloged procedure. 

Parameters 

At entry to the IEFUJP exit routine, register 1 points to a list of four-byte addresses, 
as follows: 

1. The address of the common exit parameter area. (See Figure 16.) 

2. The address of an area containing the job purge record (type 26) to be written to 
the SMF data set. 

Return Codes 

Before the IEFUJP exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 

4 indicates the job purge record is not to be written to the 

SMF data set. 

A value other than 4 indicates the job purge record is to be written to the SMF 
data set. 



IEFU29 - SMF Dump Exit 

IEFU29 receives control from the SMF writer when an SMF data set becomes full. 
A user-written IEFU29 exit routine can issue a WTOR macro instruction requesting 
the operator to start a procedure to dump the full SMF data set. 

Parameters 

At entry to the IEFU29 exit routine, register 1 points to the four-byte address of 
the data set name for the full SMF data set. 

Return Codes 

None. 



Testing Exit Routines 



One method of testing user-written exit routines is by using the TESTEXIT 
procedure in SYS1.ASAMPLIB. This procedure contains an assembler language 
source program (also named TESTEXIT) which attaches the data generator utility 
program (IEBDG) to create sample parameter lists for all user-written exit 
routines except IEFU29. (The TESTEXIT procedure creates the parameter list for 
the IEFU29 exit routine without using the data generator utility program.) The 
source program then calls each user-written exit routine being tested, and passes the 
appropriate parameter list to it. Figure 20 illustrates the input/output and control 
flow of the TESTEXIT source program. 
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Figure 20. TESTEXIT Input/Output and Control Flow 

Before using the TESTEXIT procedure : 

1 . Fulfill the following user-written exit routine testing requirements: 

• Specify a user subpool (0-1 27) in all GETM AIN macro instructions included 
in the routines. 

• Provide a special SMFWTM macro instruction in all routines that use the macro. 

• Place the routines in a partitioned data set. 

2. Obtain the TESTEXIT procedure from SYS1.ASAMPLIB. 

3. Modify the procedure to meet the installation's testing requirements. 

TESTEXIT Exit Routine Requirements 

Before using the TESTEXIT procedure, fulfill the following exit routine 
requirements: 

• Specify a user subpool (0-127) in all GETM AIN macro instructions included in 
your routines. When testing is completed, specify one of the subpools shown in 
Figure 17 for the area used to communicate between exit routines. 
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Provide a special SMFWTM macro instruction in all exit routines that use the 
macro. The special macro definition writes to the TESTEXIT data set defined by 
the DD statement named MANX. (With the normal SMFWTM macro instruction, 
the data is written to SYS1 .MANX or SYS1 .MANY.) Using this macro definition, 
then, data is processed without accessing the system data on SYS1 .MANX or 
SYS1 .MANY. When testing is completed, remove the macro definition. Figure 
21 shows the SMFWTM macro instruction that is required for using the 
TESTEXIT procedure. 





MACRO 




&NAME 


SMFWTM 


&MSGAD 




AIF 


C&MSGAD' EQ " ) ..E1 




AIF 


C&MSGAD' EQ' (1)*) BAL 




AIF 


C&MSGAD' (1/1) EQ '(') . REGA 




AGO 


.LODIT 


.E1 


MNOTE 
MEXIT 


'••• NO OPERAND SPECIFIED *** 


.BAL 


ANOP 






CNOP 


0,4 


&NAME 


BAL 


15,*+8 


.LIST 


DC 


V(TSMFWTM) 




L 


15,0(15) 




BALR 


14,15 




MEXIT 




.REGA 


ANOP 




&NAME 


LR 


1,&MSGAD(1) 




CNOP 


0,4 




BAL 


15,*+8 




AGO 


.LIST 


LODIT 


ANOP 




&NAME 


LA 


1.&MSGAD 




CNOP 


0,4 




BAL 


15,*+8 




AGO 


.LIST 




MEND 





Figure 21. SMFWTM Macro Definition Required for Using TESTEXIT 



• Place the exit routines in a partitioned data set named EXITLIB. 
shows sample JCL for entering the routines into EXITLIB. 



Figure 22 
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JOB MSGLEVEL=1 

EXEC PGM=IEBUPDTE,PARM=NEW 

DD DSNAME=EXITLIB,VOLUME=SER=231400, 

UNIT=2314,SPACE=(TRK,(10,3,D),DISP=(,KEEP), 

DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

DD SYSOUT=A 

DD DATA 

NAME=IEFUJV 



//UPDTE 

// 

//SYSUT2 

// 

// 

//SYSPRINT 

//SYS IN 

./ ADD 

(IEFUJV object deck) 

./ ADD NAME=IEFUJI 

(IE FUJI object deck) 

./ ADD NAME=IEFUSI 

(IEFUSI object deck) 

./ ADD NAME=IEFUTL 

(IEFUTL object deck) 

./ ADD NAME=IEFUSO 

( I EFUSO object deck) 

./ ADD NAME=IEFU83 

(IEFU83 object deck) 

./ ADD NAME=IEFACTRT 

(IEFACTRT object deck) 

./ ADD NAME=IEFUJP 

(IEFUJP object deck) 

./ ADD NAME=IEFU29 

(IEFU29 object deck) 

./ ENDUP 
/• 



Figure 22. Sample JCL for Entering User-Written Exit Routines into EXITLIB 

Obtaining TESTEXIT from SYS1.ASAMPLIB 

Figure 23 shows sample JCL for obtaining a punched deck of TESTEXIT from 
SYS1.ASAMPLIB. 



//PUNCH 

II 

//SYSPRINT 

//SYSUT1 

II 

//SYSUT2 

//SYS IN 



I* 



JOB 



MSGLEVEL=1 



EXEC PGM=IEBPTPCH 

DD SYSOUT=A 

DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 

UNIT=xxxx,VOLUME=SER=xxxxxx 1 



DD 

DD 

PUNCH 

MEMBER 

RECORD 



UNIT=2540-2 

* 

TYPORG=PO,MAXNAME=1 ,MAXFLDS=1 

NAME=TESTEXIT 

FIELD=(80) 



1 The volume and unit parameters depend on your installation's request. 
Figure 23. Sample JCL for Obtaining a Punched Deck of TESTEXIT 
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Modifying the TESTEXIT Procedure 

Figure 24 shows sample JCL for executing the TESTEXIT procedure in an 
unmodified system. 

//TESTEXIT JOB MSGLEVEL=1 

//TEST EXEC ASMFCL 

//ASM. SYS IN DD 

(TESTEXIT Source Module) 

/• 

//LKED.SYSLMOD DD DSNAME=TESTLIB,VOLUME=SER=231400, 

// UNIT=2314,SPACE=(TRK,(5,2,D), 

// DISP=(NEW,KEEP) 

//LKED.EXITS DD DSNAME=EXITLIB,VOLUME=SER=231400, 

// UNIT=2314,DISP=OLD 

//LKED.SYSIN DD 

INCLUDE EXITS(IEFUJV,IEFUJI,IEFUSI,IEFUTL,IEFUSO, 
IEFU83,IEFACTRT,IEFUJP,IEFU29) 

ENTRY TESTEXIT 

NAME TESTEXIT 
/• 

//DATAGEN JOB MSGLEVEL=1 

// EXEC PGM=IEBUPDTE,PARM=NEW 

7/SYSUT2 DD DSNAME=DGINPUT,UNIT=2314,DISP=(,KEEP), 

// VOLUME=SER=231400,SPACE=(TRK,(10,5,D), 

// DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

//SYSPRINT DD SYSOUT=A 

//SYS IN DD DATA 

./ ADD NAME=UJV 

(IEBDG Control Statements for IEFUJV) 
./ ADD NAME=UJI 

(IEBDG Control Statements for IEFUJI) 
./ ADD NAME=USI 

(IEBDG Control Statements for IEFUSI) 
./ ADD NAME=USO 

(IEBDG Control Statements for IEFUSO) 
./ ADD NAME=UTL 

(IEBDG Control Statements for IEFUTL) 
./ ADD NAME=U83 

(IEBDG Control Statements for IEFU83) 
./ ADD NAME=ACT 

(IEBDG Control Statements for IEFACTAT) 
./ ADD NAME=UJP 

(IEBDG Control Statements for IEFUJP) 

Figure 24. Sample JCL for Executing TESTEXIT (Part 1 of 2) 
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./ ENDUP 

/• 

//TESTING 

//JOBLIB 

II 

II 

II PARM='UJV= 

//INUJV 

II 

II 

//INUJI 

II 

II 

//INUSI 

II 

II 

//INUSO 

II 

II 

//INUTL 

II 

II 

//INU83 

II 

II 

//IN ACT 

II 

II 

//INUJP 

II 

II 

//OUTUJV 

II 

II 

//OUTUJI 

II 

II 

//OUTUSI 

// 

II 

//OUTUSO 

II 

II 

//OUTUTL 

II 

II 

//OUTU83 

II 

II 

//OUTACT 

II 

II 

//OUTUJP 

II 

II 

//MANX 

II 

II 

//SYSPRINT 

//DGPRINT 

//SYSABEND 

/• 



JOB MSGLEVEL=1 

DD DSNAME=TESTLIB,VOLUME=SER=231400, 

UNIT=2314,DISP=(OLD,KEEP) 
EXEC PGM=TESTEXIT, 
25,UJI=8,USI=8,USO=5,UTL=5,U83=12,ACT=2,UJP=2,U29=2' 
DD DSNAME=DGINPUT(UJV),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UN IT=231 4,VO LUM E=SER=231 400 
DD DSNAM£=DGINPUT(UJI),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(USI),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD.PASS). 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(USO),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB).DISP=(OLD.PASS) / 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(UTL),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(U83),DCB=(LRECL=80, 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(ACT),DCB=(LRECL=80. 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 
DD DSNAME=DGINPUT(UJP),DCB=(LRECL=80. 

BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 

DD DSNAME=UJV(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=UJI(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=USI(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(1 0,5,1 )),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=USO(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TR K(1 0,5,1 )),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=UTL(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=U83(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 
DD DSNAME=ACT(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10 / 5,1)),VOLUME=SER=231400, 
DCB=(LRECL=180,BLKSIZE=180,RECFM=FB) 
DD DS^AME=UJP(OUT),UNIT=2314,DISP=(,PASS), 

SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 
DD UNIT=2314,VOLUME=SER=231400,DSN=MANX, 

SPACE=(TRK,(3,1)),DISP=(NEW,KEEP), 
DCB=(BLKSIZE=200,LRECL=196) 

DD SYSOUT=A,DCB=(BLKSIZE=136,LRECL=132) 

DD SYSOUT=A 

OD SYSOUT=A 



Figure 24. Sample JCL for Executing TESTEXIT (Part 2 of 2) 
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A summary of the operations performed by the procedure shown in Figure 24 
is as follows: 

• The TESTEXIT job assembles the TESTEXIT source program (not illustrated in 
the figure) and link-edits it with the exit routines being tested. (Note that the 
exit routines must reside in EXITLIB, a partitioned data set.) 

• The DATAGEN job, using the IEBUPDTE utility program, creates a partitioned 
data set (DGINPUT) containing control statements for the IEBDG utility program, 
which will be attached by the TESTEXIT source program. 

• The TESTING job includes the execution of the TESTEXIT source program. 

Use the TESTEXIT procedure provided in SYS1.ASAMPLIB, without 
modification, to link-edit the sample exit routines in SYS1.ASAMPLIB, generate 
sample parameter lists, and test the sample exit routines. To adapt the TESTEXIT 
procedure to your installation's testing requirements, however, note the following 
modifications: 

• The TESTEXIT job shown in Figure 24 link-edits the TESTEXIT source program 
with the exit routines. You must substitute an INCLUDE control statement 
specifying the names of the exit routines being tested. 

• The DATAGEN job shown in Figure 24 creates a partitioned data set containing 
control statements that generate samples of standard parameter lists. You should 
omit control statements and their associated ADD statements for any exit 
routines not being tested. Note that control statements are not required for the 
IEFU29 exit routine because the TESTEXIT procedure creates the parameters 
needed to test that exit routine. When testing for special conditions or required 
additional test parameters, you must make appropriate modifications and 
additions to the control statements. 

Note that you must supply control statements in such an order that the records 
subsequently generated by the IEBDG utility program will be grouped as complete 
parameter lists that conform in length and format to the exit parameters previously 
defined in this chapter. (Be sure to include the entry code passed to exits IEFUTL 
and IEFACTRT in register as a one-byte parameter at the end of the parameter 
lists for those exits.) For detailed information on the use of IEBDG control 
statements, see OS/VS Utilities. 

• The TESTING job shown in Figure 24 includes the execution of the TESTEXIT 
source program. Values for the PARM parameter of the EXEC statement specify 
which exit routines are to be tested and the number of times each is to be tested. 
This parameter has the format: 

PARM='xxx=nn/7 , . . . ,xxx=nnn' 

where : 

XXX 

is an exit routine identifier. 

nnn 

is the number of times an exit routine is to be tested (the maximum value is 

255). 
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The DD statements to be included depend upon the exit routines being tested. 
Figure 25 shows the exit-routine identifiers, specified on the EXEC statement, and 
the DD statements that you must include for each exit routine being tested. 



Exit Routine 


Identifier 


DD Statements 


lEF.tfjV 


UJV 


INUJV.OUTUJV 


lEFUJr 


UJI 


INUJI.OUTUJI 


IEFUSI 


USI 


INUSI,OUTUSI 


IEFUTL 


UTL 


INUTL,OUTUTL 


IEFUSO 


USO 


INUSO. OUTUSO 


IEFU83 


U83 


INU83, OUTU83 


IEFACTRT 


ACT 


INACT.OUTACT 


IEFUJP 


UJP 


INUJP,OUTUJP 


IEFU29 


U29 


Not required 


Any 




MANX, SYSPRINT, DGPRINT, SYSABEND 



Figure 25. Parameters and DD Statements for Executing TESTEXIT 

Note that you must include DD statements for any other data sets used by the exit 
routines in the JCL for the TESTEXIT procedure. 
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User-Written Report Programs 



Producing a report usually requires at least two operations: sorting the SMF records 
and writing them in an appropriate format. 



Sorting SMF Records 



Any sort/merge program can be used to sort SMF records; this section describes two 
sample sort/merge exit routines that you may use with the IBM OS/VS Sort/Merge 
Program Product (Program No. 5740-SM1). (For a detailed description of this 
particular sort/merge program, see OS/VS Sort/Merge Programmer's Guide.) 

Sample Sort/Merge Exit Routines 

The IBM OS/VS Sort/Merge Program Product can, during various phases of 
execution, pass control to routines designed and written to perform specific 
functions. SYS1 .ASAMPLIB has two sample routines that receive control from 
exits E15 and E35 of this sort/merge program. The sample E15 exit routine, called 
SMFE15, extracts all SMF records without a job log identification (job name and 
time and date that the reader recognized the JOB card) from the SMF dump data 
set. SMFE15 retains the dump header and dump trailer records (types 2 and 3) in 
the temporary data set HDRDATA. It retains all other system-oriented records 
(records without a job log identification) in the temporary data set SORDATA. 

The sample E35 exit routine, called SMFE35, places all the records extracted by 
the SMFE15 routine in the sort output data set. These records are inserted in the 
data set as follows: dump header records, dump trailer records, all other system- 
oriented records, and the sorted job-oriented records. 

Note: If tape work devices are used, the minimum record length the IBM 
Sort/Merge Program Product can sort is 18 bytes. Otherwise, the minimum is one 
byte. The sample routines SMFE15 and SMFE35 use SMF record types through 
1 3 for input; the minimum length of these SMF records is 18 bytes. 

Figure 26 shows sample JCL for obtaining a listing of the SMFE15 and SMFE35 
exit routines from SYS1 .ASAMPLIB. Figure 26 also shows sample JCL for obtaining 
a listing of the SYS1 .ASAMPLIB member named SMFSORT. SMFSORT contains 
sample JCL for executing the IBM OS/VS Sort/Merge Program Product. 
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//PRINT 


JOB 


123456,SMITH 


If 


EXEC 


PGM=IEBPTPCH 


//SYSPRINT 


DD 


SYSOUT=A 


//SYSUT1 


DD 


DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 


II 




UNIT=xxxx,VOLUME=SER=xxxxxx 1 


//SYSUT2 


OD 


SYSOUT=A 


//SYSIN 


DD 


• 




PRINT 


TYPORG=PO,MAXNAME=4,MAXFl_DS=4 




MEMBER 


NAME=SMFSORT 




RECORD 


FIELD=(80) 




MEMBER 


NAME=SMFE15 




RECORD 


FIELD=(80) 




MEMBER 


NAME=SMFE35 




RECORD 


FIELD=(80) 


/* 







1 The volume and unit parameters depend on your installation's request. 
Figure 26. Sample JCL for Obtaining a Listing of Sample Sort Exit Routines 

To include the sample exit routines in your sort application, you must assemble 
and link-edit them before executing the sort/merge program. Figure 27 shows 
sample JCL for this procedure, including one possible sort application. In this 
example, SMF records are to be sorted first on the job log identification (major 
control field), and then on the time and date portions of the time stamp (minor 
control fields). Displacements of these fields (from the beginning of the physical 
record) are 19, 7, and 1 1 , respectively. 
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//SMFSORT 


JOB 


MSGLEVEL=1 


//STEP1 


EXEC 


ASMFCL 1 


//ASM. SYS IN 


DD 


• 



(E 15 Source Deck) 

/* 

//LKED.SYSLMOD 

II 

II 

//LKED.SYSIN 



/* 

//STEP2 

//ASM.SYSIN 

(E35 Source Deck) 

/' 



DD 



DD 
NAME 

EXEC 
DD 



//LKED.SYSLMOD 


DD 


// 




//LKED.SYSIN 


DD 




NAME 


/* 




//SORTSTEP 


EXEC 


//SYSOUT 


DD 


//SORT LIB 


DD 


//EXITLIB 


DD 


// 




//SORT IN 


DD 


II 


LABEL 


//SORTWK01 


DD 


//SORTWK02 


DD 


//SORTWK03 


DD 


//SORTOUT 


DD 


// 


DISP=(, 


//SORDATA 


DD 


II 




//HDRDATA 


DD 


II 




//SYS IN 


DD 


SORT 




MODS 




END 





DSNAME=SMF1.EXITS,UNIT=2314, 2 
DISP=(NEW,KEEP),SPACE=(TRK,(10,5,D), 

VOL=SER=231400 

• 

E15(R) 3 
ASMFCL 1 



DSNAME=SMF1.EXITS,DISP=(OLD,KEEP), 2 
UNIT=2314,VOL=SER=231400 

* 

E35(R) 3 

PGM=SORT,REGION=100K 4 

SYSOUT=A 

DSNAME=SYS1 .SORTLIB,DISP=SHR 

DSNAME=SMF1.EXITS,DISP=(OLD,KEEP), 5 

UNIT=2314,VQL=SER=231400 

UNIT=2400,VOL=SER=SYSMAN,DISP=OLD, 
=(,SL),DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 

UNIT=2314,SPACE=(TRK,(50),,CONTIG) 8 

UNIT=2314,SPACE=(TRK,(50),,CONTIG) 8 

UNIT=2314,SPACE=(TRK,(50),,CONTIG) 8 

UNIT=2400,DSNAME=SMF1.SORTOUT,LABEL=(,SL), 9 
,KEEP),DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 

UNIT=SYSDA,SPACE=(CYL,(1,1)), 10 

DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 

UNIT=SYSDA,SPACE=(TRK,(5,5)), 10 

DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 

FIELDS=(19,16,A,1 1, 4,A,7,4,A) ,FORMAT=BI,SIZE=E4000 11 
E15=(E15,700,EXITLIB,N),E35=(E35,1500,EXITLIB,N) 11 



/« 



*EXEC statement for cataloged procedure ASMFCL (assemble and link-edit). (For a description 
of the ASMFCL procedure, see OS/VS—VM370 Assembler Programmer's Guide.) 

2 The sample sort exit routines will be link-edited into data set SMF1. EXITS. 

3 Link-edit control statements specifying that E15 and E35 will be the load module names of the 
exit routines. 

4 EXEC statement for the sort/merge program. 

5 Data set SMF1. EXITS is specified as the library in which sort exit routines can be found. 

6 lnput to the sort program is the SMF dump data set, contained on a tape having a volume 
serial number of SYSMAN. 

7 The LRECL value can be larger than the BLKSIZE value because records might be segmented. 
The LRECL value must be as large as the longest SMF record being created plus four bytes for 
the RDW. The BLKSIZE must be equal to one-half the BUF parameter. Modify these 
parameters according to the installation's buffer size and the longest record to be collected. 



'Three sort work units are defined as being direct access devices. 
J The sort output data set is to be written on tape. 



10 



Two data sets required by the sample sort exit routines are defined on direct access devices. 

11 The sort/merge control statements define the sort control fields and exit routines to be used 
in this sort application. 

Figure 27. Sample JCL for Executing a Sort Procedure 
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Designing a Report Program 



The basic operations of a report program are formatting and printing data from 
SMF records. The input to a report program is normally the sorted SMF data set. 

SYS1 .ASAMPLIB has a sample PL/1 source report program, called SMFFRMT, 
which can format record types 0, 2, 3, 7, 9, 10, 1 1 and 17-22. Figure 28 illustrates 
sample output from the SMFFRMT program. To use this program to print selected 
types of SMF records, specify the record types to be printed, separated by commas, 
in the PARM field of the EXEC statement. To print all sample record types, the 
PARM parameter is not required. 



RECORD HEADER/RECORD 

TYPE 

02 0102 00681590 0072017F C2C2F4F5 

10 010A 00672333 0072017F C2C2F4F5 

4040404040404040 00000000 00000000 4040404040404040 0006 
0801000C 

03 0103 0068161A 0072017F C2C2F4F5 



Figure 28. Sample Output from SMFFRMT 





DATE 


720117 




PAGE 


1 


* 




* 


* 




* 


* 




. .* 


* .... 




* 


* . ... 




* 



Before using the SMFFRMT program, you must compile the program using the 
PL/1 compiler. Figure 29 shows sample JCL for executing the SMFFRMT program 
after it is compiled and link-edited into SYS1 .LINKLIB. 

//FORMAT JOB MSGLEVEL=1 

//FRMT EXEC PGM=SMI-FRMT,PARM='0,3,10*- 

//SYSPRINT DD SYSOUT=A 

//REPORT DD SYSOUT=A,DCB=(RECFM=VBA,BLKSIZE=3500) 

//SMFDATA DD DISP=(OLD,KEEP),LABEL=(,SL),VOL=SER=xxxxxx 

// UNIT=2400,DCB=(RECFM=VBS,BLKSIZE=1000) 1 

*The BLKSIZE is one-half the value specified in the BUF parameter. For this example, BUF is 
equal to 2000. See Figure 8 for the JCL defining the SMFDATA data set. 

Figure 29. Sample JCL for Executing SMFFRMT 
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SMF Records 



This chapter fully describes all of the SMF-formatted records. Note that the fields 
in these records marked "Reserved" are for use by SMF and are not-available for 
your use. 



Standard SMF Record Header 



Each record written to the SMF data set by the SMF writer routine contains the 
standard SMF record header. Each record written to the SMF data set by user- 
written routines should also include the standard record header. Figure. 30 illustrates 
the header; its length is 14 bytes. 



Offsets 


Name 


Length 


Format 


Source 


Description 








(The "Name" field in all 
of the SMF records 
contains the symbolic 
addresses defined by the ■ 
IFASMFR macro 
instruction.) 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 




1 


binary 


internal 


Record type 


2 


2 




4 


binary 


SVC 11 

or 
SVC 83 


Time, in hundredths of 
a second, record was 
moved to SMF buffer 1 


6 


6 




4 


packed 


SVC 11 

or 
SVC 83 


Date record was moved 
to SMF buffer, in the 
form 00YYDDDF where 
F is the sign 1 


10 


A 

i 


.i 


4 


EBCDIC 


JMRCPUID 

or 
SMC AS ID 


System identification 
(taken from SID 
parametpri 



x ln record types 2 and 3, these fields indicate the time and date that the record was moved to 
the dump data set. I n record types 4, 5, 34 and 35, these fields indicate the time and date 
that the job or job step terminated. 

Figure 30. Standard SMF Record Header 

Note: When using the SMFWTM macro instruction to write a record to the SMF 
data set, you must add a record descriptor word (four bytes) to the beginning of the 
record header; the address passed to the macro instruction must point to the 
beginning of the record descriptor word (RDW). For a discussion of the RDW, see 
OS/VS Data Management Services Guide. 
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Summary of SMF Records 



Figure 31 summarizes the SMF records according to the type of data they contain, 
such as VSAM or JES2 data, and the events (or status indicators) that cause SMF 
to generate the records. Also included in Figure 31 is a summary of the DSV and 
OPT SMFPRMxx parameters that control whether each record type is to be written 
to the SMF data set. To write all SMF-formatted records (except record types 2, 3 
and 7) to the SMF data set, you must specify MAN=ALL and a value for the BUF 
parameter. To write record type 1 7 for temporary data sets, you must specify 
REC=2. 

For a summary of the sizes of the SMF records, see "SMF Buffer" in the chapter 
"System Requirements and Considerations." For a summary of all of the fields in 
the SMF records, see "Appendix A: Field-to-Record Cross-Reference." 
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Category 
of Data 


Event or Status 


Record 
Type 


SMFPRMxx Definition 


DSV= 


OPT= 


Day Data 


IPL 









Devices online at IPL 


8 






19 


1,3 




22 






End of day 


19 


1,3 




MODIFY team command issued 


31 






Machine 
Data 


CPU, storage range or channel varied 
online or offline 


22 






Devices varied online 


9 






22 






Devices recovered at allocation 


10 






Devices varied offline 


11 






22 






Auxiliary 

Storage 

Data 


Space available on DASD volumes: 
at IPL, after HALT EOD or SWITCH 
SMF command, when demounted 


19 


1,3 




Tape volume closed or processed 
by EOV 


21 






VSAM data space defined, extended, 
or deleted 


69 


1,3 




Processing 
Data 


Step processing 


4 




2 


34 




2 


Job processing 


5 






35 






SYSOUT processing 


6 






26 






Job initiated 


20 






Data set dynamically unallocated, 
concatenated or deconcatenated 


40 






Non-VSAM 
Data Set 
Activity 
Data 


Data set 
closed or 
processed 
by EOV 


Data set opened for 
INPUT, or RDBACK 


14 


2,3 


2 


Data set opened for 
OUTPUT, UPDAT, 
INOUT, orOUTIN 


15 


2,3 


2 


Data set scratched 


17 


2,3 


2 


Data set renamed 


18 


2,3 


2 


VSAM 
Data Set 
Activity 
Data 


Component or cluster opened 


62 


2,3 


2 


Entry defined 


63 


2,3 


2 


Component or cluster status 


64 


2,3 


2 


Entry deleted 


67 


2.3 


2 


Entry renamed 


68 


2,3 


2 


JES2 
Data 


S JES2 or $E SYS command issued 


43 






$P JES2 command issued 


45 






$S LNEn or $E LNEn command 
issued, or remote user signed on 


47 






$P LNEn command issued or remote 
user signed off 


48 






$E LNEn command issued, or 
remote user attempted to sign on 
with invalid password 


49 







Figure 3 1, Summary of SMF Records (Part 1 of 2) 
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Category 
of Data 


Event or Status 


Record 
Type 


SMFPRMxx Definition 


DSV= 


OPT= 


JES3 
Data 


Job processed by JES3 MDS 


25 






JES3 started 


43 






JES3 terminated 


45 






RJP line started or remote 
user signed on 


47 






RJP line stopped or remote 
user signed off 


48 






Remote user attempted to sign 
on with invalid password 


49 






MF/1 
Data 1 


CPU activity 


70 






Paging activity 


71 






Workload activity 


72 






Channel activity 


73 • 






Device activity 


74 






Record 

Management 

Data 


Dump header 


2 






Dump trailer 


3 






SMF records lost 


7 






Record descriptor word (RDW) 


ALL 


N/A 


N/A 


Block descriptor word (BDW) 


N/A 


N/A 


N/A 



Records containing MF/1 data are generated at the end of each MF/1 measurement interval 



Figure 31. Summary of SMF Records (Part 2 of 2) 
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Record Type - IPL 



Record type is written by IEEMB823 after every IPL of the system. It includes 
the virtual and real storage sizes and the SMF options in effect. Its length is 
31 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMFOFLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SM FORTY 


1 


binary 


internal 


Record type 


2 


2 


SMFOTME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer- 


* 6 


6 


SMFODTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMFOSID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMFOJWT 


4 


binary 


SMCAJWT 


Limit, in minutes, of continuous wait time for the job 
(taken from JWT parameter) 


18 


12 


SMFOBUF 


4 


binary 


SMCABUF»2 


Number of bytes in SMF buffer (taken from BUF parameter) 


22 


16 


SMFOVST 


4 


binary 


(CVTMZ00+D/1024 


Number of 1 K bytes in virtual storage 


26 


1A 


SMFOOPT 


1 


binary 


SMCAOPT 


SMF options 

Bit Meaning When Set 

System and job accounting (OPT=1 ) 

1 System, job and step accounting (OPT=2) 

2 User exits will be taken (EXT=YES) 

3 Data set accounting (DSV=2 or 3) 

4 Volume accounting (DSV=1 or 3) 

5 Reserved 

6 Type 17 records will be written for temporary 
data sets (REC=2) 

7 Reserved 


27 


1B 


SMFORST 


4 


binary 


(CVTEORM+D/1024 


Number of 1 K bytes in real storage 
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Record Type 2 — Dump Header 

Record type 2 is written directly to the dump data set by IFASMFDP, the SMF 
dump program. This record consists of only the standard SMF record header. It 
indicates the beginning of a dump of the SMF data set from a direct access device 
usually to a tape. Its length is 14 bytes. 

Note: Even if M AN=USER is specified in the SMFPRMxx member of 
SYS1 .PARMLIB, a type 2 record is written. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF2FLG 


1 


binary 


IFASMFDP 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF2RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF2TME 


4 


binary 


SVC 1 1 (Set by 
IFASMFDP) 


Time, in hundredths of a second, record was moved to the 
dump data. set 


6 


6 


SMF2DTE 


4 


packed 


SVC 1 1 (Set by 
IFASMFDP) 


Date record was moved to the dump data set, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF2SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 
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Record Type 3 — Dump Trailer 

Record type 3 is written directly to the dump data set by IFASMFDP, the SMF 
dump program. This record consists of only the standard SMF record header. It 
marks the end of a dump of the SMF data set from a direct access device usually 
to a tape. Its length is 14 bytes. 

Note: Even if M AN=USER is specified in the SMFPRMxx member of 
SYS1 .PARMLIB, a type 3 record is written. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF3FLG 


1 


binary 


IFASMFDP 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF3RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF3TME 


4 


binary 


SVC 1 1 (Set by 
IFASMFDP) 


Time, in hundredths of a second, record was moved to the 
dump data set 


6 


6 


SMF3DTE 


4 


packed 


SVC 1 1 (Set by 
IFASMFDP) 


Date record was moved to the dump data set, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF3SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 
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Record Type 4 — Step Termination 

Record type 4 is written by IEFTB722 at the normal or abnormal termination of a 
job step for a background job, or when a job step is flushed during or after job 
initiation. It is not written for a job step that follows a CANCEL operator command. 
Its length is 147 bytes plus (1) eight bytes for each device entry and (2) the length of 
the step accounting fields. 

This record identifies the job step by the job log identification, step name, 
number of the step within the job, user identification, program name and perform- 
ance group number. If accounting numbers (which can be alphameric) were 
specified in the EXEC statement, they are included. 

This record also contains operating information such as the job step start and end 
times, step CPU time, amount of storage allocated and used, step termination status, 
number of records in DD DATA and DD* data sets for the step, device allocation 
start time, problem program start time, and storage protect key. It contains the 
number of page-ins, page-outs, swap-ins, and swap-outs for both VIO and non-VIO 
data sets. 

Record type 4 has an entry for each non-spooled data set that was defined by a 
DD statement. Each entry lists the device class, unit type, channel address, unit 
address, and EXCP count for the data set. 

Notes: 

1 . Data sets are recorded in the order of the step DD statements; they are not 
identified by name. (A user-written IEFUJV exit routine can record this order 
as each statement is validated.) 

2. For data sets that are dynamically unallocated, the data set entry information is 
in record type 40 — not in record type 4. 

3. For more information on EXCP count and CPU time, see Appendixes B and C, 
respectively. 
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The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF4FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF4RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF4TME 


4 


binary 


SVC 1 1 (Set by 
IEFTB722 


Time, in hundredths of a second, step terminated 


6 


6 


SMF4DTE 


4 


packed 


SVC 1 1 (Set by 
IEFTB722 


Date step terminated, in the form 00YYDDDF, where F 
is the sign 


10 


A 


SMF4SID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


SMF4JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF4RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF4RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign 1 


30 


1E 


SMF4UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common, exit parameter 
area) 


38 


26 


SMF4STN 


1 


binary 


JMRSTEP 


Step number (first step=1 , etc.) 


39 


27 


SMF4SIT 


4 


binary 


JCTJMRSS (Set by 
IEFSMFIE) 


Time, in hundredths of a second, initiator selected this step 


43 


2B 


SMF4STID 


4 


packed 


JCTSSD (Set by 
IEFSMFIE) 


Date initiator selected this step, in the form OOYYDDDF 
where F is the sign 


47 


2F 


SMF4NCI 


4 


binary 


SCTSMF 


Number of card-image records in DD DATA and DD* data 
sets read by the reader for the step 



1 The job name and the time and date that the reader recognized the JOB card for this job constitute the job 
log identification. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


51 


33 


SMF4SCC 


2 


binary 


TCBCMPC 


Step completion code: 

X'Occc' indicates system ABEND in the job step where ccc 
is the system ABEND code. (See OS/VS Message Library: 
VS2 System Codes.) 

X'8ccc' indicates user ABEND in the job step where ccc 
is the user ABEND code. 

X'nnnn' indicates normal completion where nnnn is the 
contents of the two low-order bytes in register 15 at 
termination. 

X'0000' indicates either 

(1 ) the job step was flushed (not executed) because of an 
error during allocation or in a preceding job step, or 

(2) normal job completion with a return code of 0. 

Use this field in conjunction with the step termination 
indicator field (offset 83). 


53 


35 


SMF4PRTY 


1 


binary 


SCTSDP 


Address space dispatching priority (taken from DPRTY= 
parameter on EXEC card or the APG value in CVTAPG) 


54 


36 


SMF4PGMN 


8 


EBCDIC 


SCTPGMNM 


Program name (taken from PGM= parameter on EXEC 
card). If a backward reference was used (SCTSTYPE equals 
X'80'), then this field contains *.DD. 


62 


3E 


SMF4STMN 


8 


EBCDIC 


SCTSNAME 


Step name (taken from name on EXEC card) 


70 


46 


SMF4RSH0 


2 


binary 


TCTRSZ 


Private area size, in 1K units. If ADDRSPC=REAL is 
specified/this field equals the amount of contiguous real 
storage reserved for the program (taken from REGION= 
parameter in JCL rounded to 4K boundary). See offset 98. 2 


72 


48 


SMF4SYST 


2 


binary 


TCT, GDA 
((PASTRT + 
PASIZE) 
-TCTHWM)/ 1024 


Storage used from top of private area, in 1K units. This 
storage area includes the LSQA and SWA (subpools 229, 
230, 236, 237 and 253-255), and is calculated as: highest 
address in private area minus lowest address of storage 
allocated from top of private area. If ADDRSPC=REAL 
is specified, this field equals' the amount of storage used 
that was not from the contiguous real storage reserved for 
the program. See offsets 70 and 98. 2 


74 


4A 


SMF4H0ST 


2 


binary 


(TCTLWM- 
TCTRBA)/1024 


Storage used from bottom of private area, in 1K units. This 
storage area includes subpools 0-127, 251 and 252, and is 
calculated as: highest address in bottom of private area 
minus address of private area. If ADDRSPC=REAL is 
specified, this field equals the amount of contiguous real 
storage that was used. See offsets 70 and 98. 2 


76 


4C 


SMF4RV1 


6 


binary 




Reserved 


82 


52 


SMF4SPK 


1 


binary 


TCBPKF 


Storage protect key, in the form xxxxOOOO where xxxx is 
the key 


83 


53 


SMF4STI 


1 


binary 


JCTJMRCL 
JCTJMRCL 
JCTJMRCL 
JCTSTEPR 
TCBFA 

TCTHWM 


Step termination indicator 

Bit Meaning When Set 
0-1 Reserved 

2 Canceled by exit IEFUJI 3 

3 Canceled by exit IEFUSI 3 

4 Canceled by exit IEFACTRT 3 

5 Step is to be restarted 

6 If 0, normal completion. If 1, ABEND. If step 
completion code (offset 51) equals 0322 or 0522, 
IEFUTL caused ABEND. If step completion code 
equals 0722, 1 EFUSO caused ABEND. 

7 If 0, normal completion. If 1 , step was flushed . 


84 


54 


SMF4RV2 


2 


binary 




Reserved 


86 


56 


SMF4AST 


4 


binary 


TCT AST (Set by 
IEFBB401) 


Device allocation start time, in hundredths of a second 



2 lf storage was not allocated (job step was flushed), these fields equal zero. 

3 Job steps canceled by IEFUJI and IEFUSI will not be executed; therefore bit 7 will also be on. Job steps 

canceled by IEFACTRT will cause subsequent job steps to be canceled; record type 4 is not produced for 
subsequent job steps. 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


- 
Description 


90 


5A 


SMF4PPST 


4 


binary 


TCTPPST (Set by 
IEFAB820) 


Problem program start time, in hundredths of a second 


94 


5E 


SMF4RV3 


1 


binary 




Reserved 


95 


5F 


SMF4SRBT 


3 


binary 


SCTSRBT 


Step CPU time under SRBs, in hundredths of a second. 
This field includes the CPU time for various supervisory 
routines that are dispatched via SRBs: locking routines, 
page resolution, swap control, cross-memory communica- 
tions (WAIT, POST, I/O POST), and TQE scheduling. 4 


98 


62 


SMF4RIN 


2 


binary 


TCTIEX 
SCTSSTAT 


Record indicator 

Bit Meaning When Set 

0-5 Reserved 

6 EXCP count may be wrong 5 

7 If 0, storage is virtual. If 1 , storage is real. 
8-15 Reserved 


100 


64 


SMF4RLCT 


2 


binary 


internal 


Offset from the beginning of the record header to the 
relocate section 


102 


66 


SMF4LENN 


2 


binary 


internal 


Length of device entry portion of record. Calculated as: 
(8 times the number of devices) + 2 


For e 
+0 
+1 
+2 

+3 
+4 


ach de 


/ice assigned to e 
SMF4DEVC 
SMF4UTYP 
SMF4CUAD 

SMF4EXCP 


ach non-5 
1 
1 
1 

1 
4 


pooled dai 
binary 
binary 
binary 

binary 
binary 


a set, there is an eight-byte entry with the following format: 6 

UCBTBYT3 Device class 

UCBTBYT4 Unit type 

UCBCHA Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

UCBUA Unit address 

TCTDCTR EXCP count (see offset 98) 5 


After 
Acco 
+0 

+1 

+4 

+5 


the de 
unting 


vice entries are tl 

Section : 

SMF4LNTH 
SMF4SETM 

SMF4NAF 
SMF4ACTF 


le follow 

1 
3 

1 
variable 


ing fields: 

binary 
binary 

binary 
EBCDIC 


internal 
ACTJTIME (in JCT) 

internal 

EXEC statement 


Length of accounting section, excluding this field 

Step CPU time under TCBs, in hundredths of a second. 
This field includes the CPU time for all tasks that are 
dispatched via TCBs below the level of RCT. 4 

Number of accounting fields 

Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 


Reloi 
+0 7 


:ateSe 


ction: 

SMF4PGIN 7 


4 


binary 


OUXBPIN + 
OUSBPIN 


Number of non-VIO, non-swap page-ins for this step. This 
field includes page-ins required through page faults, specific 
page requests, and page fixes. It does not include page 
- reclaims, page-ins for VI O data sets, pages that are swapped 
in, and page-ins for the common area. 



4 lf TIME=1440 is specified on the JOB statement, all timing for the job is eliminated. If TIME=1440 is specified 
on the EXEC statement and a job time limit is not specified on the JOB statement, all timing for the job step is 
eliminated. For more information, see the IEFUTL exit. 

CPU time is not expected to be constant between different runs of the same job step. For more information on 
CPU time, see Appendix C. 

5 lf a GETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, only the existing 
data sets are counted. If the functional recovery routine is entered, EXCP counting for the step is discontinued 
and no device entries are produced. If ADDRSPC=REAL is specified, the EXCP count does not include PCIs. 
For more information on EXCP count, see Appendix B. 

6 Entries for DD*, DD DATA, DD DUMMY and spooled data sets are zero. (A DD DUMMY entry results when a 
forward reference to a DD statement having that DD name is not found or when DD DUMMY is specified.) 
Entries for virtual I/O data sets are zero for class and type, and X'OFFF' for channel/unit address. 

7 The displacement of this field depends upon the size of the accounting fields and the number of devices. 
Offset 100 contains the displacement for this field. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


Relocate Section: (Continued) 








+4 




SMF4PG0T 


4 


binary 


OUXBPOUT + 
OUSBPOUT 


Number of non-VIO, non-swap page-outs for this step. 
This field includes page-outs required through specific page 
requests as well as those pages stolen by the paging 
supervisor as a result of infrequent use. It does not include 
page-outs for VIO data sets, pages that are swapped out, 
and page-outs for the common area. 


+8 




SMF4NSW 


4 


binary 


PVTNSWPS 


Number of address space swap sequences. (A swap sequence 
consists of an address space swap-out and swap-in.) 


+ 12 




SMF4PSI 


4 


binary 


PVTSPIN 


Number of pages swapped in. This field includes: LSQA, 
fixed pages, and those pages that the real storage manager 
determined to be active when the address space was 
swapped in. It does not include page reclaims nor pages 
found in storage during the swap-in process (such as pages 
brought in via SRB's started after completion of swap-in 
Stage 1 processing). 


+16 




SMF4PSO 


4 


binary 


PVTSPOUT 


Number of pages swapped out. This field includes: LSQA, 
private area fixed pages, and private area non-fixed changed 
pages. 


+20 




SMF4VPI 


4 


binary 


OUXBVAMI+ 
OUSBVAMI 


Number of VIO page-ins for this step. This field includes 
page-ins resulting from page faults or specific page requests 
on a VIO window. It does not include VIO swap-ins or 
page-ins for the common area. 


+24 




SMF4VP0 


4 


binary 


OUXBVAMO + 
OUSBVAMO 


Number of VIO page-outs for this step. This field includes 
page-outs resulting from specific page requests on a VIO 
window, as well as those pages stolen by the paging 
v supervisor as a result of infrequent use. It does not include 
VIO swap-outs or page-outs for the common area. 


+28 




SMF4SST 


4 


binary 


OUXBJBS + 
OUXBTRS 


Step service, in service units. This field is calculated as: 
total job service minus the accumulated job service prior to 
this step's initialization. 8 


+32 - 




SMF4ACT 


4 


binary 


OUXBJBT + 
OUXBTRT 


Step transaction active time, in 1024-microsecond units. 
Calculated as: total job transaction active time minus the 
accumulated transaction active time prior to this step's 
initialization. 8 


+36 




SMF4PGNO 


2 


binary 


OUCBNPG 


Step performance group number (taken from PERFORM= 
parameter on JOB or EXEC card) 8 


+38 




SMF4TRAN 


4 


binary 


OUXBJBR 


Step transaction residency time, in 1024-microsecond 
units. That is the amount of time the transaction was in 
real storage. 


+42 




SMF4RECL 


4 


binary 


OUSBPREC + 
OUXBPREC 


Number of reclaims for this step 


+46 




SMF4RCLM 


4 


binary 


OUSBVAMR + 
OUXBVAMR 


Number of VIO reclaims for this step 


+50 




SMF4CPGN 


4 


binary 


OUSBCAPI + 
OUXBCAPI 


Number of common area page-ins for this step 


+54 




SMF4CRCL 


4 


binary 


OUSBCAPR + 
OUXBCAPR 


Number of common area reclaims for this step 


+58 




SMF4PGST 


4 


binary 


OUSBSTCT + 
OUXBSTCT 


Number of pages stolen from the storage for this step 


+62 




SMF4PSEC 


8 


binary 


OUCBPSS 


Number of page seconds for this step, in. page millisecond 
units. Calculated as: the number of pages used by this step 
times the execution time it held that number of pages. 



8 For more information on service, transaction active time, and performance group number, 
see OS/VS2 System Programming Library: Initialization and Tuning Guide. 
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Record Type 5 — Job Termination 

Record type 5 is written by IKFTB722 at the normal or abnormal termination of a 
background job. Its length is I I 7 bytes plus the length of the job accounting fields. 
(The maximum length of this record is 261 bytes.) 

This record identifies the job by job log identification, user identification, 
priority, input class, and programmer's name. If accounting numbers (which can be 
alphameric) were specified in the JOB statement, they are included. 

This record also contains operating information such as the job start and end times, 
number of steps in the job, number of records in DD DATA and DD* data sets for 
the job, job termination status, device class, unit type, storage protect key, and job 
CPU time. (The job CPU time equals the sun; of the job step times.) 

Note: For more information on EXCP count and CPU time, see Appendixes B and 
C, respectively. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF5FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF5RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF5TME 


4 


binary 


SVC 1 1 (Set by 
IEFTB722 


Time, in hundredths of a second, job terminated 


6 


6 


SMF5DTE 


4 


packed 


SVC 1 1 (Set by 
IEFTB722 


Date job terminated, in the form O0YYDDDF where F is 
the sign 


10 


A 


SMF5SID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


SMF5JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF5RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the JOB 
card for this job 1 


26 


1A 


SMF5RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF5UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF5NST 


1 


binary 


JMRSTEP 


Number of steps in the job 


39 


27 


SMF5JIT 


4 


binary 


JCTJMRJT (Set by 
IEFSMFIE) 


Time, in hundredths of a second, initiator selected the job 


43 


2B 


SMF5JID 


4 


packed 


JCTJMRJD (Set by 
IEFSMFIE) 


Date initiator selected the job, in the form 00YYDDDF 
where F is the sign 


47 


2F 


SMF5NCI 


4 


binary 


JMRJOBIN 


Number of card-image records in DD DATA and DD* data 
sets read by the reader for the job 



1 The job name and the time and date that the reader recognized the JOB card for this job constitute the 
job log identification. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


51 


33 


SMF5JCC 


2 


binary 


TCBCMPC 


Job completion code: 

X'Occc' indicates system ABEND in the last job step where 
ccc is the system ABEND code (See OS/VS Message 
Library: VS2 System Codes. ) 

X'8ccc' indicates user ABEND in the last job step where ccc 
is the user ABEND code. 

X'nnnn' indicates normal completion where nnnn is the 
contents of the two low-order bytes in register 15 at 
termination. 

X'OOOO' indicates normal job completion with a return 
code of 6. 

Use this field in conjunction with the job termination 
indicator field (offset 62). 


53 


35 


SMF5JPTY 


1 


binary 


JCTJPRTY 


Job priority. This field normally equals the user-assigned 
priority of JD to 13, but if the job fails while being 
scheduled, this field equals 14 (taken from JOB card) 


54 


36 


SMF5RSTT 


4 


binary 


JMRDRSTP 


Time, in hundredths of a second, reader recognized the end 
of the job 


58 


3A 


SMF5RSTD 


4 


packed 


JMRDRSTP + 4 


Date reader recognized the end of the job, in the form 
OOYYDDDF where F is the sign 


62 


3E 


SMF5JBTI 


1 


binary 


JCTJMRCL 
JCTJMRCL 
JCTJMRCL 


Job termination indicator 

Bit Meaning When Set 
0-1 Reserved 

2 Canceled by exit I EFUJI 

3 Canceled by exit IEFUSI 

4 Canceled by exit IEFACTRT (step exit only) 
5-7 Reserved 


63 


3F 


SMF5SMCI 


1 


binary 




Reserved 


64 


40 


SMF5TRAN 


4 


binary 


OUXBJBR 


Job transaction residency time, in 1024-microsecond units. 
That is the total amount of time the transaction was in 
real storage. 3 


68 


44 


SMF5CKRE 




binary 




Reserved 


69 


45 


SMF5RDCL 




binary 


JMRRDR 


Reader device class. (This field is not filled in for jobs 
submitted via an internal reader.) 


70 


46 


SMF5RUTY 




binary 


JMRRDR 


Reader unit type. (This field is not filled in for jobs 
submitted via an internal reader.) 


71 


47 


SMF5JICL 




EBCDIC 


JCTJCSMF 


Job input class (taken from JOB card; default equals 'A') 


72 


48 


SMF5SPK 




binary 


TCBPKF 


Storage protect key, in the form xxxxOOOO where xxxx 
is the key 


73 


49 


SMF5SRBT 


3 


binary 


SCTSRBT 


Job CPU time under SRBs, in hundredths of a second. This 
field includes the CPU time for various supervisory routines 
that are dispatched via SRBs: locking routines, page 
resolution, swap control, cross-memory communications 
(WAIT, POST, I/O POST), and TQE scheduling. 2 


76 


4C 


SMF5TJS 


4 


binary 


OUXBJBS + 
OUXBTRS 


Job service, in service units 3 



2 lf TIME=1440 is specified on the JOB statement, all timing for the job is eliminated. If TIME=1440 is specified on an 
EXEC statement and a job time limit is not specified on the JOB statement, all timing for that job step is eliminated. 
For more information, see the IEFUTL exit. 



(Continued) 



CPU time may not be constant between different runs of the same job. For more information on CPU time, see Appendix C. 

3 For more information on service, transaction active time, and performance group number, see OS/VS2 System Programming 
| Library: Initialization and Tuning Guide. Note that the service, active time, and residency time may have been accumulated 
under different performance group numbers. 
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Offsets 


Name 


Length 


Format I Source 


Description 


80 


50 


SMF5TTAT 


4 


■ f ~"~ " 

binary |OUXBJBT + 

j-OUXBTRT 


Job transaction active time, in 1024-microsecond units 3 


84 


54 


SMF5RV2 


4 


binary 




Reserved 


88 


58 


SMF5PGN0 


2 


binary 


OUCBNPG 


Performance goup number of last step (taken from 
PERFORM= parameter on JOB or EXEC card) 3 


90 


5A 


SMF5RV3 


2 


binary 




Reserved 


92 


5C 


SMF5TLEN 


1 


binary 


ACTLEN (in JCT) 


Length of rest of record excluding this field 


93 


5D 


SMF5PRGN 


20 


EBCDIC 


ACTPRGNM (in JCT) 


Programmer's name 


113 


71 


SMF5JCPU 


3 


binary 


ACTJTIME (in JCT) 


Job CPU time under TCBs, in hundredths of a second. 
This field includes the CPU time for all tasks that are ' 
dispatched via TCBs below the level of RCT. 2 


116 


74 


SMF5ACTF 


1 


binary 


ACTJNFLD (in JCT) 


Number of accounting fields 


T17 


75 


SMF5JSAF 


variable 


EBCDIC 


JOB statement 


Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 



2 lf TIME=1440 is specified on the JOB statement, all timing for the job is eliminated. If TIME=1440 is 
specified on an EXEC statement and a job time limit is not specified on the JOB statement, ail timing 
for that job step is eliminated. For more information, see the IEFUTL exit. 

CPU time may not be constant between different runs of the same job. For more information on CPU 
time, see Appendix C. 

For more information on service, transaction active time, and performance group number, see OS/VS2 
System Programming Library: Initialization and Tuning Guide. Note that the service and active time 
may have been accumulated under different performance group numbers. 
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Record Type 6 - JES2 Output Writer 



Record type 6 is written by HASPPRPU (JES2 writer) or IASXSD82 (external 
writer). It is written by the JES2 writer when processing is completed for a job 
output element (JOE), or when there is a change in certain information (indicated 
by "*") describing SYSOUT data sets processed in the same JOE. The external 
writer writes this record when processing is complexed for each JOE. This record 
is also written for spin data sets. If the JES2 writer is used, the record length is 90 
bytes plus 36 bytes for the 3800 Printing Subsystem section. If an external writer 
or user-supplied writer is used, the length is 84 bytes. 

This record identifies the output writer by SYSOUT class and form number, and 
identifies the job by job log identification, JES2-assigned job number, and user 
identification. It also contains information on the output writer activity such as 
the number of logical records processed, number of data sets processed, writer start 
and end times, input/output status indicators, data set control indicators, and JES2 
logical output device name. 

This record also provides information on the activity of the 3800 Printing Sub- 
system. For additional information on the 3800, see the IBM 3800 Printing Sub- 
system Programmer's Guide. 

Note: If an external writer or user-supplied writer is used, SMF produces an 
incomplete record type 6. The incomplete record type 6 differs from the JES2 
record type 6 as follows : 

• Its length is 84 bytes - the page count field (offset 84). and the output route 
code field (offset 88) are not produced. 

• The following fields are zero : 

- Number of logical records (offset 47) 

- I/O status indicators (offset 5 1) 

- Subsystem generating identification (offset 58) 

- Data set control indicators (offset 62) 

- JES2 logical output device name (offset 68) 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF6FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF6RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF6TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 ~ 


^~ SMF6DXE__ 




packed 


SVC 83 


Date record was moved to SMF buffer, in the form 








OOYYDDDF-whereF is the sign 


10 


A 


SMF6SID 


4 


EBCDIC 


SMCASID 


System identification (talce7rfrciT»-S4©-par^rneter) 



(Continued) 



86 OS/VS2 System Management Facilities (SMF) (VS2.03.810) 



VS2.03.803 
VS2.03.810 



Offsets 


Name 


Length 


Format 


Source 


Description 


Thef 
14 
22 

26 

30 


}||owii 

\e 

16 
1A 
1E 


ig fields apply wl 
SMF6JBN 
SMF6RST 

SMF6RSD 

SMF6UIF 


len the JE 
8 
4 

4 

8 


S2 writer 
EBCDIC 
binary 

packed 

EBCDIC 


/vrites the record: 
JCTJMRN 
JCTRDRON 

JCTRDTON 

JCTUSEID 


Job name 1 

Time, in hundredths of a second, reader recognized the JOB 
card for this job 1 

Date reader recognized the JOB card for this job in the form 
00YYDDDF where F is the sign 1 

User identification (taken from common exit parameter 

area) 


I 38 


26 


SMF60WC 


1 


EBCDIC 


JOECURCL 


•SYSOUT class. (This field is blank for non-SYSOUT 
data sets.) 


39 


27 


SMF6WST 


4 


binary 


PTIMEON 

(in PPPWORK) 2 


Start time, in hundredths of a second, of print/punch 
processor working on the data in this record 


43 


2B 


SMF6WSD 


4 


packed 


PTIMEON +4 
(in PPPWORK) 2 


Start date of print/punch processor working on the data in 
this record, in the form 00YYDDDF where F is the sign 


47 


2F 


SMF6NLR 


4 


binary 


PPLNCDCT 
(in PPPWORK) 2 


Number of logical records written by the writer, by form 
number and class. (This field includes JOB LOG informa- 
tion and data set copies.) 


51 

1 

1 


33 


SMF6IOE 


1 


binary 


PPFLAGS 

(in PPPWORK) 2 


I/O status indicators 

Bit Meaning When Set 

0-4 Reserved 

*5 Data buffer read error 

6 Reserved 

*7 Control buffer read error 


52 


34 


SMF6NDS 


1 


binary 


PPJNDS 

(in PPPWORK) 2 


Number of data sets processed by the writer and included 
in this record. If multiple copies are produced, each copy 
is counted. (This field includes JOB LOG information.) 


53 


35 


SMF6FMN 


4 


EBCDIC 


DCTFORMS 


Form number 


57 


39 


SMF6PAD1 


1 


binary 


UCBTYP 


Section indicator 

Bit Meaning When Set 

3800 Printing Subsystem section present 

1-7 Reserved 


58 


3A 


SMF6SBS 


2 


binary 


internal 


Subsystem identification — X'0002' signifies JES2 


60 


3C 


SMF6LN1 


2 


binary 


internal 


Length of rest of record, including this field, but not 
including any additional sections indicated by the 
SMF6PAD1 field 


62 


3E 


SMF6DCI 


2 


binary 


PSMFDCI 

(in PPPWORK) 2 


Data set control indicators 

Bit Meaning When Set 

Reserved 

1 Record represents spin data sets 

*2 Operator terminated this data group 

*3 Operator interrupted this data group 

*4 Operator restarted this data group 

*5 Record represents continuation of interrupted 

data group 
*6 Operator overrode programmed carriage control 

(printer only) 
*7 Punch output was interpreted (3525 only) 
8-15 Reserved 


64 


40 


SMF6JNM 


4 


EBCDIC 


JCTJOBID+4 


JES2-assigned job number 


68 


44 


SMF60UT 


8 


EBCDIC 


DCTDEVN 


JES2 logical output device name 


J 76 


4C 


SMF6FCB 


4 


EBCDIC 


DCTFCB 


*FCB image identification (printer only) 


1 80 


50 


SMF6UCS 


4 


EBCDIC 


DCTUCS 


*UCS image identification (printer only) 


1 84 


54 


SMF6PGE 


4 


binary 


PRPAGECT 
(in PPPWORK) 2 


Approximate page count (printer only). A skip to any 
carriage control channel one : is counted as a page. 


88 


58 


SMF6RTE 


2 


binary 


DCTNO 


Output route code 



^•The job name and the time and date that the reader recognized the JOB card for this job constitute the 
job log identification. 

2 PPPWORK is the print/punch processor work area. 

*A change in this field will cause a new record type 6 to be written. 



(Continued) 



SMF Records 87 



VS2.03.803 
VS2.03.810 



Offsets 


Name 


Length 


Format 


Source 


Description 


3800 

+0 


Printir 


ig Subsystem Sec 

SMF6LN2 


tion: 
2 


binary 


internal 


Length of 3800 Printing Subsystem section, including 
this field 


+2 




SMF6CPS 


8 


binary 


PCOPYGRP 
(inPPPWORK) 2 


*Number of copies printed in each copy group. Each 
byte represents one copy group, and the sum of the 8 
bytes is the total number of copies printed. 


+10 




SMF6CHR 


16 


EBCDIC 


DCTCHAR1,2, 3, 4 


"Names of the character arrangement tables that define 
the characters used in printing. Each name is 4 bytes 
long, with a maximum of 4 names. 


+26 




SMF6MID 


4 


EBCDIC 


DCTMODF 


*Names of the copy modification module used to 
modify the data 


+30 




SMF6FLI 


4 


EBCDIC 


DCTFLASH 


*Name of the forms overlay printed on the copies 


+34 




SMF6FLC 


1 


binary 


PFLASHC 

(in PPPWORK) 2 


•Number of copies on which the forms overlay is 
printed 


+35 




SMF6BID 


1 


binary 


DCTPPSW2 

PPFLAG2 
(inPPPWORK) 2 


Options indicator 

Bit Meaning When Set 

*0 Output was burst into sheets by the Burster- 
Trimmer-Stacker 

*1 DCB subparameter OPTCD=J was specified. 
Each output data line contained a table 
reference character that selected the character 
arrangement table used when printing that line. 

2-7 Reserved 


Thef 
14 


ollowi 
E 


ng fields apply w 
SMF6JBN 


hen the e> 
8 


eternal wri 
EBCDIC 


ter writes the record: 

SSSOJOBN 
(in SSOB) 


Job name 1 


22 


16 


SMF6RST 


4 


binary 


job log 3 +4 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 



*A change in this field will cause a new record type 6 to be written. 

The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log identification. 

PPPWORK is the print/punch processor work area. 

3 The job log is pointed to by SSSOWTRC field in the SSOB data area. 



(continued) 



87.0 OS/VS2 System Management Facilities (SMF) (VS2.03.810) 



SMF Records 87.1 



Offsets 


'" " 

Name 


Length 


Format 


Source 


Description 


26 


1A 


SMF6RSD 


4 


packed 


job |og 3 +8 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 


30 


1E 


SMF6UIF 


8 


EBCDIC 


job log 3 +12 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF60WC 


1 


EBCDIC 


SSSOCLAS 
(in SSOB) 


SYSOUT class. (This field is blank for non-SYSOUT 
data sets.) 


39 


27 


SMF6WST 


4 


binary 


SVC 1 1 (set by 
IASXSD82) 


Start time, in hundredths of a second, Of print/punch 
processor working on the data in this record 


43 


2B 


SMF6WSD 


4 


packed 


SVC 11 (set by 
IASXSD82) 


Start date of print/punch processor working on the data in 
this record, in the form OOYYDDDF where F is the sign 


47 


2F 


SMF6NLR 


4 


binary 




Zero 


51 


33 


SMF6I0E 


1 


binary 




Zero 


52 


34 


SMF6NDS 


1 


binary 


internal 


Number of data sets processed by the writer and included 
in this record. If multiple copies are produced, each copy 
is counted. (This field includes JOBLOG information.) 


53 


35 


SMF6FMN 


4 


EBCDIC 


SSSOFORM 
(in SSOB) 


Form number 


57 


39 


SMF6PAD1 


1 


binary 




Reserved 


58 


40 


SMF6SBS 


2 


binary 




Zero 


60 


3C 


SMF6LN1 


2 


binary 


internal 


Length of rest of record, including this field 


62 


3E 


SMF6DCI 


2 


binary 




Zero 


64 


40 


SMF6JNM 


4 


EBCDIC 


SSSOJOBI +4 
(in SSOB) 


JES2-assigned job number 


68 


44 


SMF60UT 


8 


EBCDIC 


DCTDEVN 


Zero 


76 


4C 


SMF6FCB 


4 


EBCDIC 


DCTFCB 


FCB image identification (printer only) 


80 


50 


SMF6UCS 


4 


EBCDIC 


DCTUCS 


UCS image identification (printer only) 



3 The job log is pointed to by SSSOWTRC field in the SSOB data area. 



88 OS/VS2 System Management Facilities (SMF) (VS2.03.810) 



VS2.03.812 

Record Type 6 — JES3 Output Writer 

Record type 6 is written by IATOSWD for each data set processed by JES3 output 
service. One type 6 record is written for each copy with a given form name. This 
record is also written for spin data sets. Its length is 1 1 2 bytes. 

This record identifies the output writer by SYSOUT class and form number, 
and identifies the job by job log identification, JES3-assigned job number, and 
user identification. It also contains information on the output writer activity such 
as the number of logical records processed, number of data sets processed, output 
service start time and date, I/O status indicators, data set control indicators, JES3 
logical output device name, and output priority. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF6FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF6RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF6TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF6DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer in the form 
00YYDDDF where F is the sign 


10 


A 


SMF6SID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


SMF6JBN 


8 


EBCDIC 


IATISJB 


Job name 1 (taken from job's RESQ) 


22 


16 


SMF6RST 


4 


binary 


IATXTOD macro 
(Set by IATISJB) 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF6RSD 


4 


packed 


IATXTOD macro 
(Set by IATISJB) 


Date reader recognized the JOB card for this job, in 
the form 00YYDDDF where F is the sign 1 


30 


1E 


SMF6UIF 


8 


EBCDIC 


JMRUSEID 

(Set by IATOSWD) 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF60WC 


1 


EBCDIC 


OSECLASS 


SYSOUT class. (This field is blank for non-SYSOUT 
data sets.) 


39 


27 


SMF6WST 


4 


binary 


IATXTOD macro 
(Set by IATOSWD) 


Start time, in hundredths of a second, of output service 
working on the data in this record. This field is filled 
in at JES3 LOGIN time for the writer job. 


43 


2B 


SMF6WSD 


4 


packed 


IATXTOD macro 
(Set by IATOSWD) 


Start date of output service working on the data in this 
record, in the form 00YYDDDF where F is the sign. 
This field is filled in at JES3 LOGIN time for the 
writer job. 


47 


2F 


SMF6NLR 


4 


binary 


IATOSWD 


Number of logical records written by the writer, 

by form number and class. (This field is filled in when a 

data set is completed or restarted; it includes 

repeats and restarts.) 


51 


33 


SMF6IOE 


1 


binary 


IATOSWD 


I/O status indicators 
Bit Meaning When Set 
0-4 Reserved 

5 Data buffer read error 

6 Reserved 

7 Control buffer read error 



l The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 



(Continued) 



SMF Records 88.1 



VS2.03.812 



Offsets 


Name 


Length 


Format 


Source 


Description 


52 


34 


SMF6NDS 


1 


binary 


IATOSWD 


Number of data sets processed by the writer and included 
in this record. If multiple copies are produced, each copy 
is counted. (This field is filled in when a data set is 
completed or restarted; it does not include restarts ) 


53 


35 


SMF6FMN 


4 


EBCDIC 


SUPFORMS (in 
SUPUNITS entry 
for the output 
device) 


Form number 


57 


39 


SMF6PAD1 


1 


binary 




Reserved 


58 


3A 


SMF6SBS 


2 


binary 


internal 


Subsystem identification — X'0005' signifies JES3 


60 


3C 


SMF6LN1 


2 


binary 


internal 


Length of rest of record, including this field 


62 


3E 


SMF6DCI 


2 


binary 


IATOSWD 


Data set control indicators (These bits are set when a data 
set is completed or restarted.) 

Bit Meaning When Set 

Reserved 

1 Record represents spin data sets 

2 Operator terminated this data group 

3 Operator restarted data set with destination 

4 Operator restarted this data group 

5 Received operator restarted data set 

6 Operator started with single space 

7 Punch output was interpreted 
8-15 Reserved 


64 


40 


SMF6JNM 


4 


EBCDIC 


IATISJB or 
IATOSWD 


JES3-assigned job number (taken from the job's RESQ) 


68 


44 


SMF60UT 


8 


EBCDIC 


SUPDD (in 
SUPUNITS entry 
for the output 
device) 


JESS logical output device name 


76 


4C 


SMF6FCB 


4 


EBCDIC 


SUPCARR (in 
SUPUNITS entry 
for the output 
device) 


FCB image identification (printer only) 


80 


50 


SMF6UCS 


4 


EBCDIC 


SUPUCS (in 
SUPUNITS entry 
for the output 
device) 


UCS image identification (printer only) 


84 


54 


SMF6PGE 


4 


binary 


IATOSWD 


For printer, approximate page count (A skip to carriage 
control channel one is counted as a page.) For punch, 
number of cards punched. This field is filled in when a 
data set is completed or restarted. 


88 


58 


SMF6DFE 


2 


binary 


IATOSWD 


Data format error indicators (These bits are set when a 
data set is completed or restarted.) 

Bit Meaning When Set 
0-5 Reserved 

6 Some first character control data bad, default used 

7 "Bad record length (truncate or pad) 
8-15 Reserved 


90 


5A 


SMF60PR 


2 


binary 


OSEPRTY 


Output priority 


92 


5C 


SMF6GRP 


8 


EBCDIC 


SUPGROUP (in 
SUPUNITS entry 
for the output 
device) 


JES3 logical output device group name 


100 


64 


SMF6RSVJ 


8 


EBCDIC 




Reserved for JESS 


108 


6C 


SMF6RSVU 


4 


EBCDIC 




Reserved for user 



88.2 OS/VS2 System Management Facilities (SMF) VS2.03.812 



VS2.03.810 

Record Type 6 — JES3 Output Writer 

Record type 6 is written by IATOSWD for each data set processed by JES3 output 
service. One type 6 record is written for each copy with a given form name- This 
record is also written for spin data sets. Its length is 1 12 bytes plus 36 bytes for the 
3800 Printing Subsystem section. 

This record identifies the output writer by SYSOUT class and form number, 
and identifies the job by job log identification , JES3-assigned job number, and 
user identification. It also contains information on the output writer activity such 
as the number of logical records processed, number of data sets processed, output 
service start time and date, I/O status indicators., data set control indicators, JES3 
logical output device name, and output priority. 

This record also provides information on the activity of the 3800 Printing 
Subsystem. For additional information on the 3800, see the IBM 3800 Printing 
Subsystem Programmer's Guide. 











The format is: 




Offsets 


Name 


- 
Length 


Format 


Source 


Description 








SMF6FLG 


1 


binary 


SVC 83 


System indicator -V 
Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


t 


1 


SMF6RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF6TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 

SMF buffer 


6 


6 


SMF6DTE 


4 


packed 


SVC 83 


Data record was moved to SMF buffer in the form 
00YYDDDF where F is the sign 


10 


A 


SMF6SID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


SMF6JBN 


8 


EBCDIC 


IATISJB 


Job name 1 (taken from job's RESQ) 


22 


16 


SMF6RST 


4 


binary 


IATXTOD macro 
(Set by IATISJB) 


Time, in hundredths of a second, reader recognized the 

JOB card for this job 1 


26 


~i 
1A 


SMF6RSD 


4 


packed 


IATXTOD macro 
(Set by IATISJB) 


Date reader recognized the JOB card for this job, in 
the form 00YYDDDF where F is the sign 1 


30 


IE 


SMF6UIF 


8 


EBCDIC 


JMRUSEID 

(Set by IATOSWD) 


User identification (taken from common exit parameter 

area) 


38 


26 


SMFGOWC 


1 


EBCDIC 


OSECLASS 


SYSOUT class. (This field is blank for non-SYSOUT 
date sets.) 


39 


27 


SMF6WST 


4 


binary 


IATXTOD macro 
(Set by IATOSWD) 


Start time, in hundredths of a second, of output service 
working on the data in this record. This field is filled 
in at JES3 LOGIN time for the writer job. 


43 


2B 


SMF6WSD 


4 


packed 


IATXTOD macro 
(Set by IATOSWD) 


Start date of output service working on the data in this 
record, in the form 0QYYDDDF where F is the sign. 
This field is filled in at JES3 LOGIN time for the 

writer job. 


47 


2F 


SMF6NLR 


4 


binary 


IATOSWD 


Number of logical records written by the writer, 

by form number and class. (This field is filled in when a 

data set is completed or restarted; it includes 

repeats and restarts.) 


51 


33 


SMF6IOE 


1 


binary 

, 


IATOSWD 


I/O status indicators 

Bit Meaning When Set 

0-4 Reserved 

5 Data buffer read error 

6 Reserved 

7 Control buffer read error 



*The job name and the time and dyte that the reader recognized the JOB 
card for this job constitute the job log identification. 



(Continued) 



SMF Records 8&.1 



VS2.03.810 



Offsets 


Name 


Length 


Format 


Source 


Description 


52 


34 


SMF6NDS 


1 


binary 


IATOSWD 


Number of data sets processed by the writer and included 
in this record. If multiple copies are produced, each copy 
is counted. (This field is filled in when a data set is 
completed or restarted; it does not include restarts.) 


53 


35 


SMF6FMN 


4 


EBCDIC 


SUPFORMS(in 
SUPUNITS entry 
for the output 
device) 


Form number 


57 


39 


SMF6PAD1 


1 


binary 


IATOSDR 


Section indicator 

Bit Meaning When Set 

3800 Printing Subsystem section present 

1-7 Reserved 


58 


3A 


SMF6SBS 


2 


binary 


internal 


Subsystem identification — X'0005' signifies JES3 


60 


3C 


SMF6LN1 


2 


binary 


internal 


Length of rest of record, including this field, but not 
including any additional sections indicated by the 
SMF6PAD1 field 


62 


3E 


SMF6DCI 


2 


binary 


IATOSWD 


Data set control indicators (These bits are set when a data 
set is completed or restarted.) 

Bit Meaning When Set 

Reserved 

1 Record represents spin data sets 

2 Operator terminated this data group 

3 Operator restarted data set with destination 

4 Operator restarted this data group 

5 Received operator restarted data set 

6 Operator started with single space 

7 Punch output was interpreted 
8-15 Reserved 


64 


40 


SMF6JNM 


4 


EBCDIC 


IATISJB or 
IATOSWD 


JES3-assigned job number (taken from the job's RESQ) 


68 


44 


SMF60UT 


8 


EBCDIC 


SUPDD (in 
SUPUNITS entry 
for the output 
device) 


JES3 logical output device name 


76 


4C 


SMF6FCB 


4 


EBCDIC 


SUPCARR (in 
SUPUNITS entry 
for the output 
device) 


FCB image identification (printer only) 


80 


50 


SMF6UCS 


4 


EBCDIC 


SUPUCS (in 
SUPUN ITS entry 
for the output 
device) 


UCS image identification (printer only) 


84 


54 


SMF6PGE 


4 


binary 


IATOSWD 


For printer, approximate page count (A skip to carriage 
control channel one is counted as a page.) For punch, 
number of cards punched. This field is filled in when a 
data set is completed or restarted. 


88 


58 


SMF6DFE 


2 


binary 


IATOSWD 


Data format error indicators (These bits are set when a 
data set is completed or restarted.) 

Bit Meaning When Set 

0-5 Reserved 

6 Some first character control data bad, default used 

7 Bad record length (truncate or pad) 
8-1 5 Reserved 


90 


5A 


SMF60PR 


2 


binary 


OSEPRTY 


Output priority 


92 


5C 


SMF6GRP 


8 


EBCDIC 


SUPGROUPOn 
SUPUNITS entry 
for the output 
device) 


JES3 logical output device group name 


100 


64 


SMF6RSVJ 


8 


EBCDIC 




Reserved for JES3 


108 


6C 


SMF6RSVU 


4 


EBCDIC 




Reserved for user 



(continued) 



88 2 OS/VS2 System Management Facilities (SMF) (VS2.03.8 10) 



VS2.03.810 



Offsets 


Name 


Length 


Format 


Source 


Description 


3800 Printing Subsystem Section: 








+0 




SMF6LN2 


2 


binary 


internal 


Length of 3800 Printing Subsystem section, including 
this field 


+2 




SMF6CPS 


8 


binary 


OSEMODRC 


Number of copies printed in each copy group. Each byte 
represents one copy group, and the sum of the 8 bytes 
is the total number of copies printed. 


+10 




SMF6CHR 


16 


EBCDIC 


OSECHARS 


Names of the character arrangement tables that define the 
characters used in printing. Each name is 4 bytes long, 
with a maximum of 4 names. 


+26 




SMF6MID 


4 


EBCDIC 


OSEMODID 


Name of the copy modification module used to modify 
the data 


+30 




SMF6FLI 


4 


EBCDIC 


OSEFLASH 


Name of the forms overlay printed on the copies 


+34 




SMF6FLC 


1 


binary 


OSEFLCNT 


Number of copies on which the forms overlay is printed 


+35 




SMF6BID 


1 


binary 


OSESTACK 
OSEDFLG1 


Options indicator 

Bit Meaning When Set 

Output was burst into sheets by the Burster- 
Trimmer-Stacker 

1 DCB subparameter OPTCD=J was specified. Each 
output data line contained a table reference 
character that selected the character arrangement 
table used when printing that line. 

2-7 Reserved 



SMP Records 88.3 



88.4 0S/VS2 System Management Facilities (SMF) (VS2.03.810) 



Record Type 7 - Data Lost 



Record type 7 is the first record built when an SMF data set becomes available for 
recording after a period when no data sets were available. Data existing in the SMF 
buffer is written to the newly available SMF data set before record type 7 is built in 
the buffer. Consequently record type 7 is not the first record in the data set. It is 
written by IEEMB829 and its length is 24 bytes. 

This record contains a count of the SMF records that were not written, and the 
start and end times of the period during which no records were written. (The end 
time is the time recorded in offset 2.) 

Notes: 

1 . In record types 4 and 5, the time stamp reflects the time that the job step or job 
ended instead of the time that the record was moved to the SMF buffer. 
Therefore, it is possible for these records, which follow the type 7 record in the 
SMF data set, to have a time stamp earlier than that of the type 7 record. 

2. Even if MAN=USER is specified in the SMFPRMxx member of SYS1 .PARMLIB, 
a type 7 record is built and written to the SMF data set. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF7FLG 


1 


binary 


IEEMB829 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF7RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF7TME 


4 


binary 


SVC 1 1 (Set by 
IEEMB829) 


Time, in hundredths of a second, record was built in SMF 
buffer 


6 


6 


SMF7DTE 


4 


packed 


SVC 11 (Set by 
IEEMB829) 


Date record was built in SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF7SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF7NRO 


2 


binary 


SMCADSCT 


Number of SMF records lost because no SMF data sets were 
available for recording 


16 


10 


SMF7STM 


4 


binary 


SMCADSTM (Set by 
IEEMB829) 


Start time, in hundredths of a second, of period during 
which no SMF data sets were available for recording 


20 


14 


SMF7STD 


4 


packed 


SMCADSTM (Set by 
IEEMB829) 


Start date of period during which no SMF data sets were 
available for recording, in the form OOYYDDDF where F 
is the sign 
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Record Type 8 - I/O Configuration 

Record type 8 is written by IEEMB823 after the IPL of the system is completed and 
the SET DATE operator command is issued. This record identifies each device that 
is online at IPL by device class, unit type, channel address, and unit address. Its 
length is 16 bytes plus four bytes for each device online at IPL. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF8FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF8RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF8TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF8DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF8SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF8LENN 


2 


binary 


internal 


Length of rest of record including this field 


For« 
+0 
+1 
+2 

+3 


»ch on 


line device, then 
SMF8I0DV 


i is a four 
1 
1 
1 

1 


■byte entry 
binary 
binary 
binary 

binary 


r with the following fo 
UCBTBYT3 
UCBTBYT4 
UCBCHA 

UCBUA 


rmat: 

Device class 

Unit type 

Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 
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Record Type 9 - VARY ONLINE 

Record type 9 is written by ICB2MSG (for the 3850 Mass Storage Control), 
IEECLEAN, IEEVPTH, and IEE2303D when a VARY ONLINE command is 
processed. This record identifies the device being added to the configuration by 
device class, unit type, channel address, and unit address. Its length is 16 bytes plus 
four bytes for each device varied online. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF9FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF9RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF9TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF9DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF9SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF9LENN 


2 


binary 


internal 


Length of rest of record including this field 


For « 

+0 
+1 
+2 

+3 


sach de 


/ice varied online 
SMF9DVAD 


i, there is 
1 
1 
1 

1 


a four-byt 
binary 
binary 
binary 

binary 


e entry with the folic 
UCBTBYT3 
UCBTBYT4 
UCBCHA 

UCBUA 


wing format: 

Device class 

Unit type 

Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 
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Record Type 10 — Allocation Recovery 

Record type 10 is written by IEFAB488 after a successful device allocation recovery. 
Its length is 40 bytes plus four bytes for each device entry. 

This record identifies the device that is made available by device class, unit type, 
channel address, and unit address. It identifies the job requiring the allocation by 
job log identification and user identification. 

Note: This record is not produced if the operator cancels the job instead of 
attempting recovery. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF10FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF10RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF10TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF10DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF10SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF10JBIM 


8 


EBCDIC 


JMRJOB 


Job name. This field contains blanks if allocation recovery 
is for a system task l 


22 


16 


SMF10RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the JOB 
card for this job. This field equals zero if allocation recovery 
is for a system task * 


26 


1A 


SMF10RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the form 
00YYDDDF where F is the sign. This field equals zero if 
allocation recovery is for a system task 1 


30 


1E 


SMF10UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF10LN 


2 


binary 


internal 


Length of rest of record including this field 


For € 
+0 
+1 
+2 

+3 


tach de 


vice made availa 
SMF10DEV 


ble, there 
1 
1 
1 

1 


is a four-ty 
binary 
binary 
binary 

binary 


/te entry with the fo 
UCBTBYT3 
UCBTBYT4 
UCBCHA 

UCBUA 


lowing format: 

Device class 

Unit type 

Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 



1 The job name and the time and date that the reader recognized the JOB card 
for this job constitute the job log identification. 
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Record Type 1 1 - VARY OFFLINE 

Record type 1 1 is written when a VARY OFFLINE command is processed. It is 
written by ICB2MSG (for the 3850 Mass Storage Control), IEECLEAN, IEEVPTH, 
IEFAB421, IGC0005I, and IGC0905I. This record identifies the device being 
removed from the configuration by device class, unit type, channel address, and unit 
address. Its length is 16 bytes plus four bytes for each device varied offline. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF11FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF11RJY 


1 


binary 


internal 


Record type 


2 


2 


SMF11TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF11DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
0OYYDDDF where F is the sign 


10 


A 


SMF11SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF11LN 


2 


binary 


internal 


Length of rest of record including this field 


For e 
+0 
+1 
+2 

+3 


sach de 


vice varied off lin 
SMF11DEV 


e, there is 
1 
1 
t 

1 


a four-by 
binary 
binary 
binary 

binary 


te entry with the foil* 
UCBTBYT3 
UCBTBYT4 
UCBCHA 

UCBUA 


swing format: 

Device class 

Unit type 

Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 

Unit address 
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Record Type 14 - INPUT or RDBACK Data Set Activity 

Record type 14 is written for non-VSAM direct access or tape data sets that are 
defined by DD statements and opened for INPUT or RDBACK processing by 
problem programs. It is written by IFG0202H and IFG0202I when a data set, as 
described above, is closed or processed by EOV. Its length varies from 288 to 
6,412 bytes, depending upon the number of volumes for the data set. 

This record contains information (associated with both the access method used 
and the type of data set used) from the TIOT, JFCB, DCB, DEB, and UCB data 
areas. For more information about these data areas, see OS/VS2 System Data Areas. 

Note: Record type 14 is not written for a data set defined by a DD* or DD DATA 
statement. For accounting purposes, the card -image count for these data sets is 
provided in record type 4. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF14FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF14RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF14TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF14DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF14SID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


SMF14JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF14RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 2 


26 


1A 


SMF14RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign * 


30 


IE 


SMF14UID 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF14RIN 


2 


binary 


internal 

UCBTYP 
JFCBDSNM 

DCBDSORG 
DCBDSORG 

JFCDSORG 
(in JFCB) 


Record and data set indicator 
Bit Meaning When Set 

Reserved 

1 Record written by EOV (Register 14=0 if CLOSE; 
register 14=4 if EOV) 

2 DASD device 

3 Temporary data set. (A data set is temporary if it 
has a system-generated name, is created within a job 
or job step, and exists only for the duration of that 
job or job step.) 

4 DCBDSORG=DA. (The data set organization being 
used is direct access.) 

5 DCBSORGHS and DCBMACRF not EXCP. (The 
data set organization being used is indexed 
sequential and the EXCP access method is not 
being used.) 

6 JFCDSORG=IS. (The data set organization being 
used is indexed sequential.) 

7 VIO data set 
8-15 Reserved 



*The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Offsets 1 Name 


Length 


Format 


Source 


Description 


Sec 

40 


i 

ion S» 

28 


es: 

SMF14SDC 


1 


binary 


internal 


Size of DCB/DEB section. This field equals 24. 


41 


29 


SMF14NUC 


1 


binary 


internal 


Number of UCB sections. There is always one UCB section 
for each UCB currently processing except for ISAM and 
BP AM -concatenated data sets. For ISAM data sets, this 
field is calculated as: one for the index extent, one per 
volume for primary extents, and one for the overflow extent. 
For BPAM -concatenated data sets, there is one UCB section 
for each data set in the concatenated data set. 


42 


2A 


SMF14SUC 


1 


binary 


internal 


Size of each UCB section. This field equals 24. 


43 


2B 


SMF14SET 


1 


binary 


internal 


Size of ISAM extension section. This field equals 28 
(or if there are no ISAM data sets). 


44 


2C 


SMF14RV1 


4 


binary 




Reserved 


TIO 
48 


TSect 
30 


on — a portion « 

SMFTIOE1 


>f the Tl( 

1 


)T, includi 

binary 


ng: 
TIOELNGH 


Length, in bytes, of the DD entry (including all device 
entries) 


49 


31 


SMFTIOE2 


1 


binary 


TIOESTTA 


Status indicator. This field indicates the tape label 
processing to be performed; whether unallocating, 
rewinding, or unloading tape data sets is required; and 
whether this is the first DD entry for a split cylinder. 


50 


32 


SMFTIOE3 


1 


binary 


TIOEWTCT 


Number of devices requested for this data set during 
allocation 


51 


33 


SMFTIOE4 


1 


binary 


TIOELINK 


During allocation, this field indicates a link to the 
appropriate prime split, unit affinity, volume affinity, or 
suballocate TIOT entry. After allocation, it is a data set 
and device indicator. 


52 


34 


SMFTIOE5 


8 


EBCDIC 


TIOEDDNM 


DDname 


60 


3C 


SMFTIOE6 


3 


binary 


TIOEJFCB 


Relative track address (TTR) of the JFCB. During 
allocation, this field contains the TTR of the SIOT. 


63 


3F 


SMFTIOE7 


1 


binary 


TIOESTTC 


Status indicator during allocation only and set to zeros at 
the end of allocation. This field indicates whether the unit 
affinity, volume affinity, and suballocate TIOT entry are 
primary or secondary. 


JFCB Section: 

64 | 40 | SMFJFCB1 


176 


binary 


JFCB 


The JFCB, excluding JFCB extensions 


DCE 
240 


(/DEB 
F0 


Section — portic 

SMFDCBOR 


ns of the 
2 


DCB and 

binary 


DEB, including: 
DCBDSORG 


Data set organization being used 


242 


F2 


SMFDCBRF 


1 


binary 


DCBRECFM 


Record format 


243 


F3 


SMFDCBMF 


2 


binary 


DCBMACRF 


Type of I/O macro instruction and options 


245 


F5 


SMFDCBFL 


1 


binary 


DCBOFLGS 


Indicator used by the OPEN routine such as the type of the 
last I/O operation, and the return from the user's exit. 


246 


F6 


SMFDCBOP 


1 


binary 


DCBOPTCD 


Option codes used by access-method interfaces 


247 


F7 


SMF14RV2 


1 


binary 




Reserved 


248 


F8 


SMFDEBFL 


1 


binary 


DEBOFLGS 


Data set and device status indicator. This field indicates 
whether a data set is modified, new or old, and shows the 
status of DASD. 


249 


F9 


SMFDEBOP 


1 


binary 


DEBOPATB 


Indicator showing both the method of I/O processing and 
the disposition that is to be performed when an end-of- 
volume (EOV) condition occurs. 


250 


FA 


SMFDEBVL 


2 


binary 


DEBVLSEQ 


Volume sequence number. For direct access, the sequence 
number is relative to the first volume of the data set. For 
tape, the sequence number is relative to the first volume 
processed. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


For each DCB/DEB tape extension, 1 


there is a 12-byte entry with the following format: 


+0 




SMFDCBBL 


4 


binary 


DCBBLKCT 


Block count for each volume 


+4 




SMFDSSNO 


6 


binary 


UCBSQC 


Data set serial number 


+10 




SMF14RV3 


2 


binary 




Reserved 


The following 12 bytes apply to the DCB/DEB DASD extension: 




+0 




SMF14NTU 


4 


binary 


DCBFDAD 


Relative track and concatenation number (TTRN) of the 
last record processed for a physical sequential or partitioned 
data set. N is always zero except for BPAM-concatenated 
data sets. If the last operation was a read (DCBOFLGS 
bit is off) the TTR is: (1 ) zero, (2) the start of a BPAM 
member if there are two or more lOBs, or (3) the last write 
of the data set if there is one IOB. This is true because the 
access method maintains DCBFDAD while reading only if 
RECFM=FS, RECFM=FBS, or only one IOB (BUFNO, 
NCP) is used. 


+4 




SMF14NTR 


4 


binary 


TCTTKRLD 


Number of tracks released by the DADSM routine 


+8 




SMF14NER 


1 


binary 


TCTEXRLD 


Number of extents released by the DADSM routine 


+9 




SMF14RV4 


3 


binary 




Reserved 


UCB Section - a portion of the UCB 


(see offsets 41 and 42), including: 


+0 




SMFUCBCH 


1 


binary 


UCBCHA 


Channel address 2 . (A mass storage volume is indicated when 
the high-order bit of this field is on.) 


+1 




SMFUCBUA 


1 


binary 


UCBUA 


Unit address 2 


+2 




SMFSRTEV 


6 


binary 


UCBVOLI 


Volume serial number 


+8 




SMFUCBTY 


4 


binary 


UCBTYP 


Unit type 


+12 




SMFSRTES 


1 


binary 


UCBSTAB 


DASD volume status indicator. This field indicates whether 
this DASD volume is a private, public, storage, or control 
volume. 


+13 




SMF14NEX 


1 


binary 


internal (in DEB) 


Number of extents 


+14 




SMF14RV5 


2 


binary 




Reserved 


+16 




SMFEXCP 


4 


binary 


TCTDCTR 


EXCP count for entire step. Note that if a data set is 
opened and closed twice during a single step, the count in 
the second type 14 record is the sum of all EXCPs for both 
uses of the data set. (The EXCP count in the last type 14 
record for the step is equal to the corresponding entry for 
the data set in record type 4. For more information about 
EXCP count, see Appendix B.) 


For each UCB tape extension, there 


s a four-byte entry with the fol 


owing format: 


+0 




SMFSRTEF 


2 


binary 


UCBFSCT 


Data set sequence count 


+2 




SMFSRTEQ 


2 


binary 


UCBFSEQ 


Data set sequence number 


The following four bytes apply to th 


e UCB DASD extension: 




+0 




SMF14NTA 4 


binary 


DEBNMTRKfor 
all extents 


Number of tracks allocated on the device 


ISAM Extension Section (DCBDSOF 


IG=IS and DCBMACRF not EX 


CP): 


+0 




SMF14RV6 


2 


binary 




Reserved 


+2 




SMFDCBMA 


1 


binary 


DCBMAC 


Extension of I/O macro instruction field (DCBMACRF) 
for ISAM 


+3 




SMFDCBNL 


1 


binary 


DCBNLEV 


Number of index levels 


+4 




SMFDCBR3 


4 


binary 


DCBRORG3 


For each use of the data set, number of read or write 
accesses to an overflow record which is not first in a chain 
of such records 


+8 




SMFDCBNR 


4 


binary 


DCBNREC 


Number of logical records in the prime data area 


+12 




SMFDCBR2 


2 


binary 


DCBRORG2 


Number of tracks (whole or partial) remaining in the 
overflow area 



2 These fields are zero for DD*, DD DATA, DD DUMMY and spooled data sets. 
For virtual I/O data sets, the channel/unit address is X'OFFF'. 
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Offsets Name 


Length 


Format 


Source 


Description 


i 1 
ISAM Extension Section: (Continued) 






+14 




SMFDCBNO 


2 


binary 


DCBNOREC 


Number of logical records in the overflow area 


+16 




SMFDCBR1 


2 


binary 


DCBRORG1 


Number of cylinder overflow areas that are full 


+ 18 




SMF14RV7 


1 


binary 




Reserved 


+19 




SMFDEBNI 


1 


binary 


OEBNIEE 


Number of extents in the independent index area 


+20 




SMFDEBNP 


1 


binary 


DEBNPEE 


Number of extents in the prime data area 


+21 




SMFDEBNO 


1 


binary 


DEBNOEE 


Number of extents in the independent overflow area 


+22 




SMFNCYLS 


2 


binary 


internal (in DEB) 


Number of cylinders in the independent index area 


+24 




SMFNPCYL 


2 


binary 


internal (in DEB) 


Number of cylinders in the prime data area 


+26 




SMFNOCYL 


2 


binary 


internal (in DEB) 


Number of cylinders in the independent overflow area 
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Record Type 15 - OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity 

Record type 15 is written for non-VSAM direct access or tape data sets that are 
defined by DD statements and opened for OUTPUT, UPDAT, INOUT, or OUTIN 
processing by problem programs. It is written by IFG0202H and IFG0202I when 
a data set, as described above, is closed or processed by EOV. Its length varies 
from 288 to 6,412 bytes, depending upon the number of volumes for the data set. 

This record contains information (associated with both the access method used 
and the type of data set used) from the TIOT, JFCB, DCB, DEB, and UCB data 
areas. For more information about these data areas, see OS/VS2 System Data 
Areas. 

Note: Record type 15 is not written for data sets defined as SYSOUT data sets on 
DD statements. For accounting purposes, the SYSOUT logical record count is 
provided in record type 6. 

The format for this record is the same as the format for record type 14. 
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Record Type 1 7 - Scratch Data Set Status 

Record type 17 is written by IGG0290D when a non-VSAM data set that is defined 
by a DD statement (either explicitly or implicitly) is scratched. (When a DD 
statement defines a volume, all the data sets on that volume are implicitly defined.) 
This record contains the data set name, number of volumes, and volume serial 
numbers. Its length varies from 96 to 2,136 bytes, depending upon the number of 
volumes for the data set. 

Note: If REC=0 is specified, record type 17 is generated for non-temporary data 
sets only. If REC=2 is specified, this record is generated for both temporary and 
non-temporary data sets. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF17FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF17RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF17TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF17DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF17SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF17JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF17RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job * 


26 


1A 


SMF17RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign * 


30 


1E 


SMF17UID 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF17RIN 


2 


binary 




Reserved 


40 


28 


SMF17DSN 


44 


EBCDIC 


user's parameter list 


Data set name 


84 


54 


SMF17RV1 


3 


binary 




Reserved 


87 


57 


SMF17NVL 


1 


binary 


user's parameter list 


Number of volumes 


For e 

+0 

+2 


ach vo 


ume, there is a e 
SMF17RV2 
SMF17FVL 


ight-byte 
2 
6 


entry witr 
binary 
EBCDIC 


) the following format 
user's parameter list 


Reserved 

Volume serial number 



1 The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Record Type 1 8 — Rename Data Set Status 

Record type 18 is written by IGG03001 when a non-VSAM data set that is defined 
by a DD statement (either explicitly or implicitly) is renamed. (When a DD 
statement defines a volume, all the data sets on that volume are implicitly defined.) 
This record contains the old data set name, new data set name, number of volumes, 
and volume serial numbers. Its length varies from 140 to 2,180 bytes, depending 
upon the number of volumes for the data set. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF18FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF18RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF18TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF18DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF18SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF18JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF18RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the JOB 
card for this job 1 


26 


1A 


SMF18RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign x 


30 


1E 


SMF18UID 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF18RIN 


2 


binary 




Reserved 


40 


28 


SMF180DS 


44 


EBCDIC 


user's parameter list 


Old data set name 


84 


54 


SMF18NDS 


44 


EBCDIC 


user's parameter list 


New data set name 


128 


80 


SMF18RV1 


3 


binary 




Reserved 


131 


83 


SMF18NVL 


1 


binary 


user's parameter list 


Number of volumes 


Fore 

+0 

+2 


ach vo 


lume, there is an 
SMF18RV2 
SMF18FVL 


eight-byt 
2 
6 


e entry wil 
binary 
EBCDIC 


h the following forma 
user's parameter list 


t: 

Reserved 

Volume serial number 



1 The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Record Type 1 9 — Direct Access Volume 

Record type 19 is written by IGC0107H (1) for each direct access device that is 
online at IPL, (2) when a HALTlOD or SWITCH SMF command is processed, 
and (3) when a volume that is defined by a DD statement is demounted. Its length 
is 64 bytes. 

This record contains the volume serial number, VTOC address, owner 
identification, unit type, number of unused alternate tracks, number of unallocated 
cylinders and tracks, number of cylinders and tracks in the largest free extent, and 
number of unallocated extents. It also contains the channel address, unit address, 
and module identification for devices having movable address plugs. 

Notes: 

1 . Record type 19 is not produced for DOS volumes used under the operating 
system. 

2. In order to determine the latest status of a shared file, the CPU clocks must be 
synchronized. 
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The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF19FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF19RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF19TME 


4 


binary 


SVC 83 


Time, irt hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF19DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF19SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF19RV1 


2 


binary 




Reserved 


16 


10 


SMF19VOL 


6 


EBCDIC 


volume label 1 
(VOLSERNO) 


Volume serial number 


22 


16 


SMF190ID 


10 


EBCDIC 


volume label 1 
(VOLOWNER) 


Owner identification of direct access volume 


32 


20 


SMF19DEV 


4 


binary 


UCBTYP 


Unit type 


36 


24 


SMF19VTC 


5 


binary 


volume label 1 
(VOLVTOC) 


VTOC address 


41 


29 


SMF19VTI 


1 


binary 


DS4VTOCI 
(in DSCB4) 

DS4DIRF 
DS4DICVT 


VTOC indicator 

Bit Meaning When Set 

0-4 Reserved 

5 Possible VTOC error 

6 VTOC error has been fixed 

7 Reserved 


42 


2A 


SMF19NDS 


2 


binary 


internal 


Number of DSCBs, calculated as: number of DSCBs per 
track times number of tracks in VTOC 


44 


2C 


SMF19DSR 


2 


binary 


DS4DSREC 
(in DSCB4) 


Number of DSCBOs, that is, number of available DSCBs 


46 


2E 


SMF19NAT 


2 


binary 


DS4NOATK 
(in DSCB4) 


Number of unused alternate tracks 


48 


30 


SMF19SPC 


2 


binary 


internal (DSCB5) 


Number of unallocated cylinders 


50 


32 




2 


binary 


internal (DSCB5) 


Number of unallocated tracks 


52 


34 


SMF19LEX 


2 


binary 


internal (DSCB5) 


Number of cylinders in the largest unallocated extent 


54 


36 




2 


binary 


internal (DSCB5) 


Number of tracks in the largest unallocated extent 


56 


38 


SMF19NUE 


2 


binary 


internal (DSCB5) 


Number of unallocated extents 


58 


3A 


SMF19RV2 


2 


binary 




Reserved 


60 


3C 


SMF19CUU 


1 


binary 


UCBCHA 


Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 


61 


3D 




1 


binary 


UCBUA 


Unit address 


62 


3E 


SMF19IND 


2 


binary 


internal 


Module identification or drive number indicating physical 
identity of devices having moveable address plugs. This 
field is taken from bits 2-7 of sense byte 4 for these 
devices. (See the component descriptions of these devices 
for the meaning of sense byte 4.) 



1 The volume label for the direct access device is record 3 of cylinder of track 0. 
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Record Type 20 — Job Initiation 

Record type 20 is written by IEFSMFIE at job initiation (including TSO logon). 
This record contains the job log identification, user identification, programmer's 
name, number of accounting fields on the JOB statement, and accounting fields. 
Its length is 61 bytes plus the length of the JOB statement accounting fields. 

The format is : 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF20FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF20RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF20TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF20DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF20SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF20JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF20RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF20RSD 


4 


packed 


JM RE DATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF20UID 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF20RIN 


2 


binary 




Reserved 


40 


28 


SMF20PGM 


20 


EBCDIC 


ACTPRGNM (in JCT) 


Programmer's name 


60 


3C 


SMF20NAF 


1 


binary 


ACTJNFLD(inJCT) 


Number of accounting fields 


61 


3D 


SMF20ACT 


variable 


EBCDIC 


JOB statement 


Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 



x The job name and the time and date that the reader recognized the 
JOB card for this job constitute the job log identification. 
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Record Type 21 - Error Statistics by Volume 

Record type 21 is written by IGC0009A when a user data set on magnetic tape is 
demounted. This record contains statistics for the entire volume during the period 
of time that the volume is mounted regardless of the number of data sets on the 
volume being accessed and regardless of the number of CLOSE macro instructions 
issued. Its length is 44 bytes. 

This record contains the volume serial number, channel address, unit address, 
unit type, and tape density. It also contains the number of: temporary and 
permanent read and write errors, START I/Os, noise blocks, erase gaps, and cleaner 
actions. 

Notes : 

1. The IFHSTATR utility program formats and prints the error-statistics-by-volume 
(ESV) information in this record. For a detailed description of this utility 
program, see OS/VS Utilities. 

2. If a maximum count is reached, a type 21 record is generated indicating the 
maximum. When the volume is demounted, another type 21 record is generated 
indicating the count since the maximum had been reached. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF21FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF21RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF21TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF21DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF21SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF21LGH 


2 


binary 


internal 


Length of rest of record including this field. (This field is 
always 30.) 


16 


10 


SMF21VOL 


6 


EBCDIC 


UCBVOLI 


Volume serial number 


22 


16 


SMF21CA 




binary 


UCBCHA 


Channel address 


23 


17 






binary 


UCBUA 


Unit address 


24 


18 


SMF21UCB 


4 


binary 


UCBTYP 


* Unit type 


28 


1C 


SMF21TR 




binary 


UCBTR 


Number of temporary read errors 


29 


1D 


SMF21TW 




binary 


UCBTW 


Number of temporary write errors 


30 


1E 


SMF21SIO 


2 


binary 


UCBSIO 


Number of START l/Os 


32 


20 


SMF21PR 




binary 


UCBPR 


Number of permanent read errors 


33 


21 


SMF21PW 




binary 


UCBPW 


Number of permanent write errors 


34 


22 


SMF21NB 




binary 


UCBNB 


Number of noise blocks 


35 


23 


SMF21ERG 


2 


binary 


UCBERG 


Number of erase gaps 


37 


25 


SMF21CLN 


2 


binary 


UCBCLN 


Number of cleaner actions 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


39 


27 


SMF21DEN 


1 


binary 


DCBOEN 

DCBMTDNO 
DCBMTDN1 
DCBMTDN2 
DCBMTDN3 
DCBMTDN4 


Tape density — 2400 and 3400 series magnetic tape units 
Bits Meaning When Set 

Code 7 -Track 9-Track 
6,7 200 BPI N/A 
1,6,7 1 556 BPI N/A 
0,6,7 2 800 BPI 800 BPI 
0,1,6,7 3 N/A 1600 BPI 
0,1,3,6.7 4 N/A 6250 BPI 


40 


28 


SMF21BLS 


2 


binary 


DCBBLKSI 


Block size. This field is zero if DCBRECFM indicates 
variable or unblocked records, or if you are doing your own 
EXCP processing. 


42 


2A 


SMF21RV0 


2 


binary 




Reserved (not necessarily zero) 



1 04 OS/VS2 System Management Facilities (SMF) 



Record Type 22 — Configuration 

Record type 22 is written (1) by ICB2MSG and IEEMB823 after every IPL of the 
system, (2) by lEECLEAN when a VARY CPU or VARY CH operator command is 
processed, (3) by lEEMPVST when a VARY STOR operator command is processed, 
and (4) by IGC0012F when a VARY ONLINE,S or VARY OFFLINE,S operator 
command is processed. This record describes the CPU, channel, storage range or 
mass storage device that is varied. It also describes the MSS units online at IPL. 
Its length is 18 bytes plus the length of the sections in the record. 

Notes: 

1 . During system initialization, the Mass Storage Control (MSC) creates a 
configuration record (called Message 92) and puts it in a message buffer. After 
SMF is initialized, ICB2MSG creates the "MSS IPL Configuration section" of 
record type 22 from the Message 92 in the MSC buffer. 

2. By using the VARY ONLINE,S and VARY OFFLINE,S commands, the 
operator can modify the configuration. (The format of these commands is 
described in Operator's Library: IBM 3850 Mass Storage System (MSS) Under 
OS/VS.) In a record type 22, a "VARY ONLINE,S section" or a "VARY 
OFFLINE,S section" is written for each unit varied by these commands. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF22FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF22RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF22TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF22DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF22SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF22IND 


2 


binary 


IEEMB82^ 

lEECLEAN/ 

lEEMPVST 

lEECLEAN/ 

lEEMPVST 

ICB2MSG 

IGC0012F 

IGC0012F 


Record creator indicator 

Value Meaning 

1 IPL 

2 VARY ONLINE 

3 VARY OFFLINE 

4 MSS at IPL 

5 VARYONLINE,S 

6 VARYOFFLINE.S 


16 


10 


SMF22ECT 


2 


binary 


internal 


Number of sections following 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


CPU Section: 










+0 




SMF22RV0 




binary 




Reserved 


+1 




SMF22PID 




binary 


IEECLEAN 


CPU section identification. (This field is always 1 .) 


+2 




SMF22CPN 


2 


binary 


IEECLEAN 


CPU model number (taken from VARY CPU command) 


+4 




SMF22RV1 




binary 




Reserved 


+5 




SMF22CPA 




binary 


IEECLEAN 


CPU address (taken from VARY CPU command or default 
in PSACPUPA) 


Channel Section: 










+0 




SMF22RV2 




binary 




Reserved 


+1 




SMF22CID 




binary 


IEECLEAN 


Channel section identification. (This field is always 2.) 


+2 




SMF22CHN 


2 


binary 


IEECLEAN 


Channel type and model number (taken from VARY CH 
command) 


+4 




SMF22CHA 




binary 


IEECLEAN 


Channel address (taken from VARY CH command) 


+5 




SMF22CPD 




binary 


IEECLEAN 


CPU address (taken from VARY CH command or default 
in PSACPUPA) 


Storage Section: 










+0 




SMF22RV3 




binary 




Reserved 


+1 




SMF22TID 




binary 


IEEMPVST 


Storage section identification. (This field is always 3.) 


+2 




SMF22PGL 


2 


binary 


IEEMPVST 


Address of lowest page in real contiguous storage (taken 
from VARY STOR command) 


+4 




SMF22NPG 


2 


binary 


IEEMPVST 


Number of pages in real contiguous storage (taken from 
VARY STOR command) 


MSS IPL Configuration Sectii 


)n: 








+0 




SMF22Ry4 


1 


binary 




Reserved 


+1 




SMF22MD 


1 


binary 


ICB2MSG 


MSS IPL configuration section identification. (This field 
is always 4.) 


The following 40 bytes conta 


in the bit 


pattern o 


f MSS units online at IPL: 


+2 




SMF22ION 


1 


binary 


(See Note 1) 


Data recording devices (DRDs) of MSF(0) 

Bit SSID 

200 

1 201 

2 202 

3 203 

4 204 

5 205 

6 206 

7 207 


+3 






1 


binary 




Data recording devices (DRDs) of MSFO) 

Bit SSID 

210 

1 211 

2 212 

3 213 

4 214 

5 215 

6 216 

7 217 


+4 






2 


binary 




Reserved 


+6 






2 


binary 




Staging Adapters 

Bit SSID 

800 

1 810 

2 820 

3 830 

15 8F0 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


MSS IPL C( 


infiguration Sectic 


n: (Cor 


itinued) 






+8 






1 


binary 




Device recording controls (DRCs) of MSF(O) 
Bit SSID 

400 

1 401 

2 402 

3 403 

Device recording controls (DRCs) of MSF0) 

4 410 

5 411 

6 412 

7 413 


+9 






1 


binary 




Reserved 


+10 






28 


binary 




Staging spindles in staging data groups (SDGs) 

SDG Bits SS/Ds 

0-7 000-007 

1 0-7 008-00 F 

2 0-7 010-017 

3 0-7 018-01 F 

27 0-7 0E8-0EF 


+38 






3 


binary 




Reserved 


+41 






1 


binary 




MSF indicator 

Bit Meaning When Set 

MSF(0) with SSID of 101 

1 MSF(0> with SSID of 102 

2 MSF (1) with SSID of 111 

3 MSF(1) with SSID of 112 
4-7 Reserved 


VARY ONLINE^ Section: 










+0 




SMF22RV5 


1 


binary 




Reserved 


+1 




SMF22NID 


1 


binary 


IGCQ012F 


VARY ONLINE.S section identification. (This field is 
always 5.) 


+2 




SMF22RVA 


1 


binary 




Reserved 


+3 




SMF22NSI 


3 


binary 


IGC0012F 


Subsystem identification of device (taken from VARY 
ONLINE,S command) 


VARY OFFLINE.S Section: 










+0 




SMF22RV6 


1 


binary 




Reserved 


+1 




SMF22FID 


1 


binary 


IGC0012F 


VARY OFFLINE.S section identification. (This field is 
always 6.) 


+2 




SMF22RVB 


1 


binary 




Reserved 


+3 




SMF22FSI 


3 


binary 


IGC0012F 


Subsystem identification of device (taken from VARY 
OFFLINE,S command) 
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Record Type 25 — JES3 Device Allocation 

Record type 25 is written by IATPURG for each job processed by JES3 main device 
scheduling (MDS). One type 25 record is written for all device allocations required 
through the user's DD statements for the job. In addition, separate type 25 records 
are written for each group of JES3 allocations for private catalogs required for the 
job, and for each dynamic allocation request. Its length is 88 bytes. 

This record contains allocation-related information such as the number of tape 
and disk volumes fetched and mounted, the time and date of the first mount 
message, and the time and date of JES3 device verification. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF25FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF25RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF25TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF25DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF25SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF25JBN 


8 


EBCDIC 


JSTJBNAM 


Job name 1 


22 


16 


SMF25RST 


4 


binary 


JMRENTRY (Set 
by IATISJB) 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF25RSD 


4 


packed 


JMREDATE (Set 
by IATISJB) 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF25UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


Desc 
38 


riptor S 
26 


ectiort: 

SMF25IND 


2 


binary 


JST25FG1 


Allocation indicators 
Bit Meaning When Set 

If 0, allocation by user's DD statements. 
If 1 , dynamic allocation. 

1 If 0, non-catalog allocation by JES3. 
If 1 , catalog allocation by JES3. 

2 If 0, manual allocation by operator. 

If 1, automatic allocation by JES3. (See the MDS 
parameter SETPARAM in OS/VS2 System 
Programming Library: JES3 System 
Programmer's Guide for more information.) 
3-15 Reserved 


40 


28 


SMF25NTF 


4 


binary 


JST25NIF 


Number of tape volumes required for the job to 
execute (fetched) 


44 


2C 


SMF25NDF 


4 


binary 


JST25NDF 


Number of disk volumes required for the job to 
execute (fetched) 


48 


30 


SMF25FST 


4 


binary 


JST25FST (Set 
by IATMDFE) 


Time, in hundredths of a second, fetch processing started. 
That is, the time that the first phase of MDS started. 
(During this phase, messages are issued to inform the 
operator of the volumes required for the job to execute.) 



^The job name and the time and date that the reader recognized the 
JOB card for this job constitute the job log identification. 
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VS2.03.812 



Offsets 


Name 


Length 


Format 


Source 


Description 


Desc 
52 


riptor S 
34 


Section (Continu 
SMF25FSD 


3d) 
4 


packed 


JST25FSD (Set 
by IATMDFE) 


Date fetch processing started, in the form 00YYDDDF 
where F is the sign 


56 


38 


SMF25SST 


4 


binary 


JST25SST (Set 
by IATMDDR) 


If manual allocation, time *START SETUP operator 
command issued (see Operator's Library: OS/VS2 
Reference (JES3) ). If automatic allocation, this field 
contains zeros. 


60 


3C 


SMF25SSQ 


4 


packed 


JST25SSD (Set 
by IATMDDR) 


If manual allocation, date 'START SETUP operator 
command issued. If automatic allocation, this field 
contains zeros. 


64 


40 


SMF25NTM 


4 


binary 


JST25NTM 


Number of tape volumes mounted 


68 


44 


SMF25NDM 


4 


binary 


JST25NDM 


Number of disk volumes mounted 


72 


48 


SMF25MST 


4 


binary 


JST25MST (Set 
by IATMDSL) 


Time, in hundredths of a second, of first volume mount 
message. If no mounts were required, this field equals 
the time of JES3 allocation. 


76 


52 


SMF25MSD 


4 


packed 


JST25MSD (Set 
by IATMDSL) 


Date of first volume mount message, in the form 
00YYDDDF where F is the sign. If no mounts were 
required, this field equals the date of JES3 allocation. 


80 


56 


SMF25VVT 


4 


binary 


JST25VVT (Set 
by IATMDVE) 


Time, in hundredths of a second, of JES3 device 
verification 


84 


5A 


SMF25VVD 


4 


packed 


JST25VVD (Set 
by IATMDVE) 


Date of JES3 device verification, in the form 
00YYDDDF where F is the sign 
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Record Type 26 - JES2 Job Purge 

Record type 26 is written by HASPMISC at job purge after all SYSOUT for the job 
is processed. This record identifies the job by job log identification, JES2-assigned 
job number and programmer's name. 

Record type 26 also contains operating information such as, message class, job 
class, JES2 job selection priority, JES2 logical input device name, output lines, 
output punched cards, print/punch route codes, and start and stop times for the 
reader, converter, execution processor, and output processor. Its length js 232 
bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF26FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF26RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF26TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF26DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF26SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF26JBN 


8 


EBCDIC 


JCTJMRJN 


Job name 1 


22 


16 


SMF26RST 


4 


binary 


JCTRDRON 


Time, in hundredths of a second/reader recognized the 
JOB card for this job 1 


26 


1A 


SMF26RSD 


4 


packed 


JCTRDTON 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF26UIF 


8 


EBCDIC 


JCTUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF26RSV 


4 


binary 




Reserved 


42 


2A 


SMF26SBS 


2 


binary 


internal 


Subsystem identification — X'0002' signifies JES2 


44 


2C 


SMF26IND 


2 


binary 




Reserved 


Desc 

46 


riptor 
2E 


Section : 

SMF26LN1 


2 


binary 


internal 


Length of descriptor section, including this field 


48 


30 


SMF26RV1 


2 


binary 




Reserved 


50 


32 


SMF26IN2 


1 


binary 


JCTJOBFL 


Job information indicator 

Bit Meaning When Set 

Background batch job 

1 Foreground TSO user 

2 System task 

3 No journal option 

4 No output option 

5 TYPRUN=SCAN was specified 

6 TYPRUN=COPY was specified 

7 Reserved 



1 The job name and the time and date that the reader recognized the JOB card for this 
job constitute the job log identification. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


MSS IPL Configuration Sectic 


in: (Cor 


tinued) 






+8 






1 


binary 




Device recording controls (DRCs) of MSF(O) 
Bit SSID 

400 

1 401 

2 402 

3 403 

Device recording controls (DRCs) of MSF(1) 

4 410 

5 411 

6 412 

7 413 


+9 






1 


binary 




Reserved 


+10 






28 


binary 




Staging spindles in staging data groups (SDGs) 

SDG Bits SSIDs 

0-7 000-007 

1 0-7 008-OOF 

2 0-7 010-017 

3 0-7 018-01 F 

27 0-7 0E8-0EF 


+38 






3 


binary 




Reserved 


+41 






1 


binary 




MSF indicator 

Bit Meaning When Set 

MSF(0) with SSID of 101 

1 MSF(0) with SSID of 102 

2 MSF(1) with SSID of 111 

3 MSF(1) with SSID of 112 
4-7 Reserved . 


VARY ONLINE^ Section: 










+0 




SMF22RV5 


1 


binary 




Reserved 


+1 




SMF22NID 


1 


binary 


IGC0012F 


VARY ONLINE.S section identification. (This field is 
always 5.) 


+2 




SMF22RVA 


1 


binary 




Reserved 


+3 




SMF22NSI 


3 


binary 


IGC0012F 


Subsystem identification of device (taken from VARY 
ONLINE.S command) 


VARY OFFLINE,S Section: 










+0 




SMF22RV6 


1 


binary 




Reserved 


+ 1 




SMF22FID 


1 


binary 


IGC0012F 


VARY 0FFLINE,S section identification. (This field is 
always 6.) 


+2 




SMF22RVB 


1 


binary 




Reserved 


+3 




SMF22FSI 


3 


binary 


IGC0012F 


Subsystem identification of device (taken from VARY 
OFFLINE,S command) 



SMF Records 107 



VS2.03.803 

Record Type 26 — JES2 Job Purge 

Record type 26 is written by HASPMISC at job purge after all SYSOUT for the job 
is processed. This record identifies the job by job log identification, JES2-assigned 
job number and programmer's name. 

Record type 26 also contains operating information such as, message class, job 
class, JES2 job selection priority, JES2 logical input device name, output lines, 
output punched cards, print/punch route codes, and start and stop times for the 
reader, converter, execution processor, and output processor. Its length is 232 
bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF26FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF26RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF26TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF26DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF26SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF26JBN 


8 


EBCDIC 


JCTJMRJN 


Job name 1 


22 


16 


SMF26RST 


4 


binary 


JCTRDRON 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF26RSD 


4 


packed 


JCTRDTON 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF26UIF 


8 


EBCDIC 


JCTUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF26RSV 


4 


binary 




Reserved 


42 


2A 


SMF26SBS 


2 


binary 


internal 


Subsystem identification — X'0002' signifies JES2 


44 


2C 


SMF26IND 


2 


binary 




Reserved 


Desc 

46 


riptor 
2E 


Section: 

SMF26LN1 


2 


binary 


internal 


Length of descriptor section, including this field 


48 


30 


SMF26RV1 


2 


binary 




Reserved 


50 


32 


SMF26IN2 


1 


binary 


JCTJOBFL 


Job information indicator 

'Bit Meaning When Set 

Background batch job 

1 Foreground TSO user 

2 System task 

3 No journal option 

4 No output option 

5 TYPRUN=SCAN was specified 

6 TYPRUN=COPY was specified 

7 RESTART = Y was specified 














(Continued) 



1 The job name and the time and date that the reader recognized the JOB card for this 
job constitute the job log identification. 
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Offsets | Name 


Length 


Format 


Source 


Description 


Oescr 

51 


ptorS 

33 


action: (Contini 
SMF26INF 


led) 
1 


binary 


JCTJOBFL 


Job information indicator 

Bit Meaning When Set 

/* PRIORITY card present or keyword 
'PRTY =' was specified on JOB card 

1 /* SETUP card(s) present 

2 TYPRUN=HOLD was specified 

3 No job log option 

4 Execution batching 

5 Job was entered on internal reader 

6 Job was rerun by JES2 

7 Job was canceled by the operator 


52 


34 


SMF26JNM 


4 


EBCDIC 


JCTJOBID + 4 


JES2-assigned job number 


56 


38 


SMF26JID 


8 


EBCDIC 


JCTJOBID 


Job identification in the form xxxOyyyy where yyyy is the 
JES2-assigned job number and xxx is: 

JOB - for normal JES2 job 

STC — for started task control job 

TSU - for TSO job 


64 


40 


SMF26NAM 


20 


EBCDIC 


JCTPNAME 


Programmer's name (taken from JOB card) 


84 


54 


SMF26MSG 




EBCDIC 


JCTMCLAS 


Message class (taken from JOB card) 


85 


55 


SMF26CLS 




EBCDIC 


JCTJCLAS 


Job class (taken from JOB card) 


86 


56 


SMF26XPI 




binary 


JCTIPRIO 


JES2 job selection priority when the job was initially read 


87 


57 


SMF26XPS 




binary 


JCTPRIO 


JES2 job selection priority when the job was selected 


88 


58 


SMF260PI 




binary 


JCTIOPRI 


JES2 initial output selection priority 


89 


59 


SMF260PS 




binary 


JCTOPRIO 


JES2 output selection priority when the output was 
selected 


90 


5A 


SMF26LOC 


2 


binary 


JCTROUTE 


input route code 


92 


5C 


SMF26DEV 


8 


EBCDIC 


JCTINDEV 


JES2 logical input device name 


100 


64 


SMF26ACT 


4 


EBCDIC 


JCTACCTN 


Programmer's accounting number 2 


104 


68 


SMF26ROM 


4 


EBCDIC 


JCTROOMN 


Programmer's room number 2 


108 


6C 


SMF26XTM 


4 


binary 


JCTETIME 


Estimated execution time, in hundredths of a second 2 


112 


70 


SMF26ELN 


4 


binary 


JCTESTLN 


Estimated output lines 2 


116 


74 


SMF26EPU 


4 


binary 


JCTESTPU 


Estimated output punched cards 2 


120 


78 


.SMF26FRM 


4 


EBCDIC 


JCTFORMS 


Output form number 2 


124 


7C 


SMF26CYP 


2 


binary 


JCTCPYCT 


Job print copy count 2 


126 


7E 


SMF26LIN 


2 


binary 


JCTLINCT 


Lines per page 2 


128 


80 


SMF26PRR 


2 


binary 


JCTPROUT 


Job print route code 


130 


82 


SMF26PUR 


2 


binary 


JCTPUOUT 


Job punch route code 


132 


84 


SMF26PDD 


8 


EBCDIC 


JCTPROCN 


Procedure DDNAME used for JCL conversion 


Evenl 
140 


sSect 
8C 


on: 

SMF26LN2 


2 


binary 


internal 


Length of events section, including this field 


142 


8E 


SMF26RV2 


2 


binary 




Reserved 


144 


90 


SMF26RPT 


4 


binary 


JCTRDROF 


Reader stop time, in hundredths of a second 


148 


94 


SMF26RPD 


4 


packed 


JCTRDTOF 


Reader stop date, in the form 00YYDDDF where F is 
the sign 


152 


98 


SMF26CST 


4 


binary 


JCTCNVON 


Converter start time, in hundredths of a second 


156 


9C 


SMF26CSD 


4 


packed 


JCTCDTON 


Converter start d8te, in the form 00YYDDDF where F 
is the sign 


160 


A0 


SMF26CPT 


4 


binary 


JCTCNVOF 


Converter stop time, in hundredths of a second 


164 


A4 


SMF26CPD 


4 


packed 


JCTCDTOF 


Converter stop date, in the form 00YYDDDF where F 
is the sign 



2 These fields are JES2-defined subfields from the accounting information field in 
the JOB card or default values assigned for this job. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


Evem 
168 


tsSecti 
A8 


on: (Continued) 
SMF26XST 


4 


binary 


JCTXEQON 


Execution processor start time, in hundredths of a second 


172 


AC 


SMF26XSD 


4 


packed 


JCTXDTON 


. Execution processor start date, in the form OOYYDDDF 
where F is the sign 


176 


BO 


SMF26XPT 


4 


binary 


JCTXEQOF 


Execution processor stop time, in hundredths of a second 


180 


B4 


SMF26XPD 


4 


packed 


JCTXDTOF 


Execution processor stop date, in the form OOYYDDDF 
where F is the sign 


184 


B8 


SMF260ST 


4 


binary 


JCTOUTON 


Output processor start time, in hundredths of a second 


188 


BC 


SMF260SD 


4 


packed 


JCTODTON 


Output processor start date, in the form OOYYDDDF 
' where F is the sign 


192 


CO 


SMF260PT 


4 


binary 


JCTOUTOF 


Output processor stop time, in hundredths of a second 


196 


C4 


SMF260PD 


4 


packed 


JCTODTOF 


Output processor stop date, in the form OOYYDDDF 
where F is the sign 


Actus 
200 


Is Sect 
C8 


ion: 
. SMF26LN3 


2 


binary 


internal 


Length of actuals section, including this field 


202 


CA 


SMF26RV4 


2 


binary 




Reserved 


204 


CC 


SMF26ICD 


4 


binary 


JCTCARDS 


Number of input cards for job. This field includes JCL and 
SYS IN cards. 


208 


DO 


SMF26XLN 


4 


binary 


JCTLINES 


Number of output lines generated to spool 


212 


D"4 


SMF26XPU 


4 


binary 


JCTPUNCH 


Number of punched cards generated to spool 


216 


D8 


SMF26RID 


4 


EBCDIC 


JCTRDSID 


Input processor system (CPU) identification 


220 


DC 


SMF26CID 


4 


EBCDIC 


JCTCVSID 


Conversion processor system (CPU) identification 


224 


EO 


SMF26XID 


4 


EBCDIC 


JCTEXSID 


Execution processor system (CPU) identification 


228 


E4 


SMF260ID 


4 


EBCDIC 


JCTOTSID 


Output processor system (CPU) identification 
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Record Type 26 — JES3 Job Purge 

Record type 26 is written by lATPURG at job purge after all SYSOUT for the job 
is processed. This record identifies the job by job log identification, J ES3-assigned 
job number, and programmer's name. 

Record type 26 also contains operating information such as message class, job 
class, JES3 job selection priority, JES3 logical input device name, execution time, 
output lines, output punched cards, deadline schedule type, deadline schedule time 
and date, and the start and stop times and dates for the reader, the converter, the 
execution processor, and the output processor. Its length is 314 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF26FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF26RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF26TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF26DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF26SID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


SMF26JBN 


8 


EBCDIC 


IATISJB 


Job name 1 (taken from job's RESQ) 


22 


16 


SMF26RST 


4 


binary 


IATXTOD macro 
(Set by IATISJB) 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF26RSD 


4 


packed 


IATXTOD macro 
(Set by IATISJB) 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF26UIF 


8 


EBCDIC 


JMRUSEID 

(Set by lATPURG) 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF26RSV 


4 


binary 




Reserved 


42 


2A 


SMF26SBS 


2 


binary 


internal 


Subsystem identification — X'0005' signifies JES3 


44 


2C 


SMF26IND 


2 


binary 




Reserved 


Desc 

46 


riptorS 

2E 


ection : 

SMF26LN1 


2 


binary 


internal 


Length of descriptor section, including this field 


48 


30 


SMF26RV1 


2 


binary 




Reserved 


50 


32 


SMF26IN3 


1 


binary 


lATISNT 
lATISDL 

lATPURG 

lATISPR 

lATNJDJ 

lATNJDJ 

lATDJOT 

lATDJIN 


Job information indicator 
Bit Meaning When Set 

Dependent job (//* NET card processed) 

1 Deadline scheduling (DEADLINE parameter was 

specified on //* MAIN card) 

2 Deadline job met deadline 

3 Process job (//* PROCESS card processed) 

4 Job left system via NJP (network job processing) 

5 Job entered system via NJP 

6 Job left system via DJ (dump job) 

7 Job entered system via DJ 



1 The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


Descriptor Section: (Continued) 








51 


33 


SMF26INF 


1 


binary 


IATISJB 

IATIIDR 
IATISJB 

IATISJB 
lATMSINfor ASP, 

or IATMSMS for 

JES3 
IATPURG 


Job information indicator 
Bit Meaning When Set 

Job priority (taken from PRTY= parameter on 

JOB card) 

1 Job processed by preexec setup 

2 TYPRUN=HOLD was specified on JOB card 
3-4 Reserved 

5 Job was entered on internal reader 

6 Job was rerun on an ASP main reader or a JES3 

reader 

7 Job was canceled by the operator 


52 


34 


SMF26JNM 


4 


EBCDIC 


IATISJB or 
IATPURG 


JES3-assigned job number (taken from job's RESQ) 


56 


38 


SMF26JID 


8 


EBCDIC 


IATISJB 


Job identification in the form xxxOyyyy where yyyy is the 
JES3-assigned job number and xxx is: 

JOB - for normal JES3 job 

STC — for started task control job 

TSU - for TSO job 


64 


40 


SMF26NAM 


20 


EBCDIC 


IATIIPR 


Programmer's name (taken from JOB card) 


84 


54 


SMF26MSG 


1 


EBCDIC 


IATISJB 


Message class (taken from MSGCLASS= parameter on 
JOB card) 


85 


55 


SMF26CLS 


1 


EBCDIC 


IATISJB 


Job class (taken from CLASS= parameter on JOB card). 
This field is blank if the default is used or if a valid 
CLASS= parameter is specified on the //* MAIN card. 
See offset 1 72. 


86 


56 


SMF26XPI 


1 


binary 


IATISJB if 
PRTY= parameter 
or IATISEN 


JES3 job selection priority when the job was initially 
read (taken from: 1) PRTY= parameter on JOB card, 
2) class default priority from main processor job class 
table, or 3) default priority from TVT) 


87 


57 


SMF26XPS 


1 


binary 


IATMSIN for 
ASP, IATMSMS 
for JES3 


JES3 job selection priority when the job was selected 
(taken from job's RESQ) 


88 


58 


SMF26RV8 


4 


binary 




Reserved 


92 


5C 


SMF26DEV 


8 


EBCDIC 


IATISJB or 
IATNJDJ if NJP 


JES3 logical input device name, or user identification if 
TSO job, or line name if NJP job 


100 


64 


SMF26RVA 


8 


binary 




Reserved 


108 


6C 


SMF26XTM 


4 


binary 


IATIIPR 


Estimated execution time, in seconds 


112 


70 


SMF26ELN 


4 


binary 


IATISMN if 
LINES= parameter 
or IATISJB if 
default 


Estimated output lines (taken from LINES= parameter on 
//* MAIN card or default (JOBLINES field in TVT times . 
1000)) 


116 


74 


SMF26EPU 


4 


binary 


IATISMN if 
CARDS= parameter 
or IATISJB if 
default 


Estimated output punched cards (taken from CARDS= 
parameter on //* MAIN card or default (JOBCARDS 
field in TVT times 100)) 


120 


78 


SMF26DTY 


1 


EBCDIC 


IATISDL 


Deadline schedule type (taken from DEADLINE parameter 
on //* MAIN card). Valid types are A-Zand 0-9. 


121 


79 


SMF26RV6 


3 


binary 




Reserved 


124 


7C 


SMF26IGP 


8 


EBCDIC 


IATISJB 


JES3 logical input device group name 


132 


84 


SMF26PD3 


8 


EBCDIC 


IATISMN if 
PROC= parameter 
or IATISJB if 
default 


Procedure DDNAME used for JCL conversion (taken from 
PROC= parameter on //* MAIN card or default 
(IATPLBST)) 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


Desc 

140 


riptor J 
8C 


Section: (Continu 

SMF26NJO 


ed) 
8 


EBCDIC 


IATNJDJ 


Name of system to which job is sent via NJP 


148 


94 


SMF26NJI 


8 


EBCDIC 


IATNJDJ 


Name of local NJP terminal supplied by the JES3 
initialization deck 


156 


9C 


SMF26NET 


8 


EBCDIC 


IATISNT 


Identification of dependent job net to which this job 
belongs (taken from //* NET card) 


164 


A4 


SMF26DTM 


4 


binary 


IATISDL 


Deadline schedule time, in hundredths of a second (taken 
from DEADLINE parameter on //* MAIN card) 


168 


A8 


SMF26DDT 


4 


packed 


IATISDL 


Deadline schedule date, in the form 00YYDDDF where F 
is the sign (taken from DEADLINE parameter on 
//'MAIN card) 


172 


AC 


SMF26CLN 


8 


EBCDIC 


IATISMN if 
CLASS= parameter 
or IATISJB. 
if default 


Job class (taken from CLASS= parameter on //* MAIN 
card if valid, or the default (JS3BATCH)) 


Even 
180 


ts Sect 
B4 


ion: 

SMF26LN2 


2 


binary 


internal 


Length of events section, including this field 


182 


B6 


SMF26RV2 


2 


binary 




Reserved 


184 


B8 


SMF26RPT 


4 


binary 


lATXTOD macro 
(Set by IATISJB) 


Reader stop time, in hundredths of a second. This field is 
filled in during JOB card processing. 


188 


BC 


SMF26RPD 


4 


packed 


lATXTOD macro 
(Set by IATISJB) 


Reader stop date in the form 00YYDDDF where F is 
the sign. This field is filled in during JOB card processing. 


192 


CO 


SMF26CST 


4 


binary 


lATXTOD macro 
(Set by IATIIDR) 


Converter start time, in hundredths of a second. This field 
is filled in following the JES3 LOGIN of the interpreter job. 


196 


C4 


SMF26CSD 


4 


packed 


CVTDATE 

(Set by IATIIDR) 


Converter start date, in the form 00YYDDDF where F 

is the sign. This field is filled in following the JES3 LOGIN 

of the interpreter job. 


200 


C8 


SMF26CPT 


4 


binary 


lATXTOD macro 
(Set by IATIIDR) 


Converter stop time, in hundredths of a second. This field 
is filled in at the end of the interpreter function. 


204 


CC 


SMF26CPD 


4 


packed 


CVTDATE 

(Set by IATIIDR) 


Converter stop date, in the form 00YYDDDF where F 

is the sign. This field is filled in at the end of the interpreter 

function. 


208 


DO 


SMF26XST 


4 


binary 


lATXTOD macro 
(Set by lATMSIN 
for ASP, or 
lATMSMS for 
JES3) 


Execution processor start time, in hundredths of a second. 
This field is filled in when the job is scheduled to run on an 
ASP main processor or a JES3 local or global processor. 


212 


D4 


SMF26XSD 


4 


packed 


CVTDATE (Set by 
lATMSIN for ASP, 
or lATMSMS for 
JES3) 


Execution processor start date, in the form 00YYDDDF 
where F is the sign. This field is filled in when the job is 
scheduled to run on an ASP main processor or a JES3 
local or global processor. 


216 


D8 


SMF26XPT 


4 


binary 


lATXTOD macro 
(Set by IATMSTM 
for ASP, or 
lATMSMS for 
JES3) 


Execution processor stop time, in hundredths of a 
second. This field is filled in when the job is terminated 
on an ASP main processor or a JES3 local or global 
processor. 


220 


DC 


SMF26XPD 


4 


packed 


lATXTOD macro 
(SetbylATMSTM 
for ASP, or 
lATMSMS for 
JES3) 


Execution processor stop date, in the form 00YYDDDF 
where F is the sign. This field is filled in when the job is 
terminated on an ASP main processor or a JES3 local 
or global processor. 


224 


E0 


SMF260ST 


4 


binary 


lATXTOD macro 
(Set by IATOSDR) 


Output processor start time, in hundredths of a second. 
This field is filled in when output service starts 
to process the job's data sets. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


Even 
228 


tsSect 

E4 


ion: (Continued) 
SMF260SD 


4 


packed 


IATXTOD macro 
(Set by IATOSDR) 


Output processor start date, in the form 00YYDDDF 
where F is the sign. This field is filled in when output 
service starts to process the job's data sets. 


232 


E8 


SMF260PT 


4 


binary 


IATXTOD macro 
(Set by IATOSWS) 


Output processor stop time, in hundredths of a second. 
This field is filled in: 1) when an RQ is removed from the 
writer queue, 2) when all output OSEs are deleted/ 
released, and 3) when a request from the SYSOUT 
interface is processed. 


236 


EC 


SMF260PD 


4 


packed 


IATXTOD macro 
(Set by IATOSWS) 


Output processor stop date, in the form 00YYDDDF where 
F is the sign. This field is filled in: DwhenanRQis 
removed from the writer queue, 2) when all output OSEs 
are deleted/released, and 3) when a request from the 
SYSOUT interface is processed. 


Actu 
240 


als Sec 

F0 


tion: 

SMF26LN3 


2 


binary 


internal 


Length of actuals section, including this field 


242 


F2 


SMF26RV4 


2 


binary 




Reserved 


244 


F4 


SMF26I0O 


4 


binary 


IATISEN 


Number of input cards for job. This field includes JCL 
and SYSIN cards. 


248 


F8 


SMF26XLN 


4 


binary 


lATMSTM 
for ASP, or 
lATMSMS for 
JES3 


Number of output lines generated to spool. This field is 
filled in when the job is terminated on an ASP main 
processor or a JES3 local or global processor. 


252 


FC 


SMF26XPU 


4 


binary 


lATMSTM for 
ASP, or lATMSMS 
for JES3 


Number of punched cards generated to spool. This field is 
filled in when the job is terminated on an ASP main 
processor or a JES3 local or global processor. 


256 


100 


SMF26RID 


4 


EBCDIC 


TVTCPUID 
(Set by I AT IS JB) 


Input processor system (CPU) identification 


260 


104 


SMF26CID 


4 


EBCDIC 


TVTCPUID 
(Set by IATIIDR) 


Conversion processor system (CPU) identification 


264 


108 


SMF26XID 


4 


EBCDIC 


TVTCPUID 

(Set by lATMSMS) 


Execution processor system (CPU) identification 


268 


10C 


SMF260ID 


4 


EBCDIC 


TVTCPUID 

(Set by IATOSDR) 


Output processor system (CPU) identification 


272 


120 


SMF26JAF 


42 


EBCDIC 


JOB statement 


Reserved for job accounting fields 
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Record Type 3 1 — TIOC Initialization 

Record type 31 is written by IKJGG001 when a MODIFY team operator command 
is issued. This record contains the number of time-sharing buffers, buffer size, 
maximum number of output and input buffers allowed per terminal before OWAIT 1 
or LWAIT 2 , OWAIT and RESTART thresholds, number of buffers reserved on the 
free queue, and the size of one terminal status block. Its length is 54 bytes. 

The format is : 



Offsets 


Name 


Length 


Format 


Source 


Description 








TTIRFLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


TTIRCDTY 


1 


binary 


internal 


Record type 


2 


2 


TTIRCDTS 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


TTIRCDTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


TTICPUID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


TTINBF 


2 


binary 


TIOCNBF 
(in TIOCRPT) 


Number of time-sharing buffers 


16 


10 


TTIBUFSE 


2 


binary 


TIOCBFSZ 
(in TIOCRPT) 


Time-sharing buffer size, in bytes 


18 


12 


TTIRSVRD 


2 


binary 




Reserved 


20 


14 


TTIOMAX 


2 


binary 


TIOCAOMX 
(in TIOCRPT) 


Maximum number of output buffers allowed per terminal 
before OWAIT 1 


22 


16 


TTIIMAX 


2 


binary 


TIOCAIMX 
(in TIOCRPT) 


Maximum number of input buffers allowed per terminal 
before LWAIT 2 


24 


18 


TTIOWTH 


2 


bi nary 


TIOCWTH 
(in TIOCRPT) 


OWAIT threshold. The number of buffers that must be 
freed in order to be freed from OWAIT. 1 


26 


1A 


TTIRSTH 


2 


binary 


TIOCRSTH 
(in TIOCRPT) 


RESTART threshold. The number of buffers that must 
be freed in order to be freed from LWAIT. 2 


28 


1C 


TTIUSLW 


2 


binary 


TIOCUSLW 
(in TIOCRPT) 


Number of buffers reserved on the free queue. (Less than 
this number results in a system-wide LWAlT. 2 ) 


30 


1E 


TTIUSSL 


2 


binary 




Reserved 


32 


20 


TTITSBS 


1 


binary 


TIOCTSBS 
(in TIOCRPT) 


Size of one terminal status block (TSB) 


33 


21 


TTIUSCH 


21 


binary 




Reserved 



1 OWAIT is the suspension of the program during input/output processing to the terminal 
because no output buffers are available. 

2 LWAIT is the locking of the terminal's keyboard because the terminal user filled all of 
the available input buffers. 
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Record Type 34 — TS-Step Termination 

Record type 34 is written by IEFTB722 when the TSO logoff function processes a 
job step termination. Its length is 147 bytes plus (1) eight bytes for each device 
entry and (2) the length of the step accounting fields. 

This record identifies the job by job name, logon time and date, user identification, 
program name, and performance group number. If accounting numbers (which can 
be alphameric) were specified on the EXEC card, they are included. 

This record also contains operating information such as initiator start time, 
number of TPUTs issued, nurnber of TGETs satisfied, amount of storage allocated 
and used, termination status, device allocation start time, problem program start 
time, step CPU time and storage protect key. It contains the number of page-ins, 
page-outs, swap-ins, and swap-outs for both VIO and non-VIO data sets. 

Record type 34 also has an entry for each non-spooled data set that was defined 
by a DD statement. Each entry lists the device class, unit type, channel address, 
unit address, and EXCP count for the data set. 

Notes: 

1 . Data sets are recorded in the order of the step DD statements; they are not 
identified by name. (A user-written IEFUJV exit routine can record this order 
as each statement is validated.) 

2. For data sets that are dynamically unallocated, the data set entry information is 
in record type 40 - not in record type 34. 

3. For more information on EXCP count and CPU time, see Appendixes B and C, 
respectively. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








TIVRFLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


TIVRCDTY 


1 


binary 


internal 


Record type- 


2 


2 


TIVRCDTS 


4 


binary 


SVC 1 1 (Set by 
IEFTB722) 


Time, in hundredths of a second, step terminated 


6 


6 


TIVRCDTE 


4 


packed 


SVC 1 1 (Set by 
IEFTB722) 


Date step terminated, in the form OOYYDDDF where F 
is the sign 


10 


A 


TIVCPUID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


TIVUIF 


8 


EBCDIC 


JMRJOB 


Job name 


22 


16 


TIVONTME 


4 


binary 


JMRENTRY 


Logon time, in hundredths of a second 


26 


1A 


TIVONDTE 


4 


packed 


JMREDATE 


Logon date, in the form OOYYDDDF where F is the sign 


30 


1E 


TIVUDATA 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


TIVINVSQ 


1 


binary 


JMRSTEP 


Step number. (This field always equals 1.) 


39 


27 


TIVSIT 


4 


binary 


JCTJMRSS (Set by 
IEFSMFIE) 


Time, in hundredths of a second, initiator selected this step 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


43 


2B 


TIVOUTCT 


4 


binary 


TCT LOUT 


Number of lines of terminal output, that is, number of 
TPUTs issued 


47 


2F 


TIVINCT 


4 


binary 


TCTLIN 


Number of lines of terminal input, that is, number of 
TGETs satisfied 


51 


33 


T I VST AT 


2 


binary 


TCBCMPC 


Step completion code: 

X'Occc' indicates system ABEND where ccc is the system 
ABEND code. (See OS/VS Message Library: VS2 System 
Codes. ) 

X'8ccc' indicates user ABEND where ccc is the user ABEND 
code. 

X'nnnn' indicates normal completion where nnnn is the 
contents of the two low-order bytes in register 15 at 
termination. 

X'0000' indicates either (1) the job step was flushed (not 
executed) because of an error during allocation, or 
(2) normal job completion with a return code of 0. 

Use this field in conjunction with the step-termination 
indicator field (offset 83). 


53 


35 


TIVPRI 


1 


binary 


SCTSDP 


Address space dispatching priority (taken from DPRTY= 
parameter on EXEC card or the APG value in CVTAPG) 


54 


36 


TIVPRGNM 


8 


EBCDIC 


SCTPGMNM 


Program name (taken from PGM= parameter on EXEC 
card). If a backward reference was used (SpTSTYPE 
equals X'80'), then this field contains *.DD. 


62 


3E 


TIVINVNM 


8 


EBCDIC 


^SCTSNAME 


Step name (taken from name on EXEC card) 


70 


46 


TIVEFRGN 


2 


binary 


TCTRSZ 


Private area size in 1 K units. If ADDRSPC=fREAL is 
specified, this field equals the amount of contiguous real 
storage reserved for the program (taken from REGION= 
parameter in JCL rounded to 4K boundary). 
See offset 98 Z 1 


72 


48 


TIVSYST 


2 


binary 


TCT, GDA 
((PASTRT + 
PASIZE) - 
TCTHWM)/1024 


Storage used from top of private area, in 1 K units. This 
storage area includes the LSQA and SWA (subpools 229, 
230, 236, 237 and 253-255), and is calculated as: 
highest address in private area minus lowest address of 
storage allocated from top of private area. 
If ADDRSPC=REAL is specified, this field equals the 
amount of storage used that was not from the contiguous 
real storage reserved for the program. See offsets 70 
and 98. 1 


74 


4A 


TIVMCRE 


2 


binary 


(TCTLWM - 
TCTRBA)/1024 


Storage used from bottom of private area, in 1 K units. 
This storage area includes subpools 0-127, 251 and 252, 
and is calculated as: highest address in bottom of private 
area minus address of private area. If ADDRSPC=REAL is 
specified, this field equals the amount of contiguous real 
storage that was used. See offsets 70 and 98. 1 


76 


4C 


TIVRVC 


6 


binary 




Reserved 


82 


52 


TIVSPK 


1 


binary 


TCBPKF 


Storage protect key, in the form xxxxOOOO where xxxx 
is the key 



*lf storage was not allocated (job step was flushed), these fields equal zero. 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


83 


53 


TIVSTI 


1 


binary 


JCTJMRCL 
JCTJMRCL 
JCTJMRCL 
JCTSTEPR 

TC8FA 
TCTHWM 


Step termination indicator 

Bit Meaning When Set 
0-1 Reserved 

2 Canceled by exit I EFUJ I 2 

3 Canceled by exit IEFUSI 2 

4 Reserved 

5 Step is to be restarted 

6 If 0, normal completion. 

If 1 , ABEND. If step completion code (offset 51 ) 
equals 0322 or 0522, IEFUTL caused ABEND. 
If step completion code equals 0722, IEFUSO 
caused ABEND. 

7 If 0, normal completion. 
If 1, step was flushed. 


84 


54 


TIVRV1 


2 


binary 




Reserved 


86 


56 


TIVAST 


4 


binary 


TCTAST (Set by 
IEFBB401) 


Device allocation start time, in hundredths of a second 


90 


5A 


TIVPPST 


4 


binary 


TCTPPST (Set by 
IEFAB820) 


Problem program start time, in hundredths of a second 


94 


5E 


TIVRV2 


1 


binary 




Reserved 


95 


5F 


TIVSRBT 


3 


binary 


SCTSRBT 


Step CPU time under SRBs, in hundredths of a second. 
This field includes the CPU time for various supervisory 
routines that are dispatched via SRBs: locking routines, 
page resolutdon, swap control, cross-memory communica- 
tions (WAIT, POST, I/O POST), and TQE scheduling. 3 


98 


62 


TIVRIN 


2 


binary 


TCTIEX 
SCTSSTAT 


Record indicator 

Bit Meaning When Set 
0-5 Reserved 

6 EXCP count may be wrong 4 

7 If 0, storage is virtual. 
If 1, storage is real. 

8-15 Reserved 


100 


64 


TIVRLCT 


2 


binary 


internal 


Offset from the beginning of the record header to the 
relocate section 


102 


66 


TIVVAR 


2 


binary 


internal 


Length of device entry portion of record. Calculated as: 
(8 times the number of devices) + 2 


For « 


?ach de 


vice assigned to e 


ach non-s 


pooled da 


ta set, there is an eight-byte entry with the following format: 5 


+0 




TIVDEVC 


1 


binary 


UCBTBYT3 


Device class 


+1 




TIVUTYP 


1 


binary 


UCBTBYT4 


Unit type 


+2 




TIVCUAD 


1 


binary 


UCBCHA 


Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 


+3 






1 


binary 


UCBUA 


Unit address 


+4 




TIVNEXCP 


4 


binary 


TCTDCTR 


EXCP count (see offset 98) 4 



2 Job steps canceled by IE FUJI and IEFUSI will not be executed; therefore bit 7 will also be on. 

3 lf TIME=1440 is specified on the JOB statement, all timing for the job is eliminated; If TIME=1440 is 
specified on the EXEC statement and a job time limit is not specified on the JOB statement, all timing for 
the job step is eliminated. For more information, see the IEFUTL exit. 

CPU time is not expected to be constant between different runs of the same job step. For more infqrmation 
on CPU time, see Appendix C. 

4 lf a GETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, only the existing 
data sets are counted. If the functional recovery routine is entered, EXCP counting for the step is discontinued 
and no device entries are produced. If ADDRSPC=REAL is specified, the EXCP count does not include PCIs. 
For more information on EXCP count, see Appendix B. 

5 Entries for DD*, DD DATA, DD DUMMY and spooled data sets are zero. (A DD DUMMY entry results when a 
forward reference to a DD statement having that DD name is not found or when DD DUMMY is specified.) 
Entries for VIO data sets are zero for class and type, and X'OFFF' for channel/unit address. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


After the device entries are the follow 


ng fields: 






Accounting Section: 










+0 




TIVVARA 


1 


binary 


internal 


Length of accounting section, excluding this field 


+1 




TIVCPUTM 


3 


binary 


ACTJTIME (in JCT) 


Step CPU time under TCBs, in hundredths of a second. 
This field includes the CPU time for all tasks that are 
dispatched via TCBs below the level of RCT. 3 


+4 




TIVNBRAC 


1 


binary 


internal 


Number of accounting fields 


+5 




TIVACFLD 


variable 


EBCDIC 


EXEC statement 


Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 


Relocate Section : 










+0 6 




TIVPGIN 6 


4 


binary 


OUXBPIN + 
OUSBPIN 


Number of non-VIO, non-swap page-ins for this step. 
This field includes page-ins required through page faults, 
specific page requests, and page fixes. It does not include 
page reclaims, page-ins for VIO data sets, pages that are 
swapped in, and page-ins for the common area. 


+4 




TIVPGOUT 


4 


binary 


OUXBPOUT + 
OUSBPOUT 


Number of non-VIO, non-swap page-outs for this step. 
This field includes page-outs required through specific page 
requests as well as those pages stolen by the paging 
supervisor as a result of infrequent use. It does not include 
page-outs for VIO data sets, pages that are swapped out, 
and page-outs for the common area. 


+8 




TIVRGNS 


4 


binary 


PVTNSWPS 


Number of address space swap sequences. (A swap sequence 
consists of an address space swap-out and swap-in.) 


+12 




TIVSIN 


4 


binary 


PVTSPIN 


Number of pages swapped in. This field includes: LSQA, 
fixed pages, and those pages that the real storage manager 
determined to be active when the address space was 
swapped in. It does not include page reclaims nor pages 
found in storage during the swap-in process (such as pages 
brought in via SRB's started after completion of swap-in 
Stage 1 processing). 


+16 




TIVSOUT 


4 


binary 


PVTSPOUT 


Number of pages swapped out. This field includes: LSQA, 
private area fixed pages, and private area non-fixed changed 
pages. 


+20 




TIVVPI 


4 


binary 


OUXBVAMI+ 
OUSBVAMI 


Number of VIO page-ins for this step. This field includes 
page-ins resulting from page faults or specific page requests 
on a VIO window. It does not include VIO swap-ins or 
page-ins for the common area. 


+24 




TIVVPO 


4 


binary 


OUXBVAMO + 
OUSBVAMO 


Number of VIO page-outs for this step. This field includes 
page-outs resulting from specific page requests on a VIO 
window, as well as those pages stolen by the paging 
supervisor as a result of infrequent use. It does not include 
VIO swap-outs or page-outs for the common area. 


+28 




TIVSST 


4 


binary 


OUXBJBS + 
OUXBTRS 


Step service, in service units 7 


+32 




TIVACT 


4 


binary 


OUXBJBT + 
OUXBTRT 


Step transaction active time, in 1 024-microsecond units 7 


+36 




TIVPGNO 


2 


binary 


OUCBNPG 


Step performance group number (taken from PERFORM= 
parameter on JOB or EXEC card) 7 



(continued) 



3 lf TIME=1440 is specified on the JOB statement, all timing for the job is eliminated. If TIME=1440 
is specified on the EXEC, statement and a job time limit is not specified on the JOB statement, all timing 
for the job step is eliminated. For more information, see the IEFUTL exit. 

CPU time is not expected to be constant between different runs of the same job step. For more information 
on CPU time, see Appendix C. 

6 The displacement of this field depends upon the size of the accounting fields and the number of devices. 
Offset 100 contains the displacement for this field. 

7 For more information on service, transaction active time, and performance group number, see OS/VS2 System 
Programming Library: Initialization and Tuning Guide. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


+38 


TIVTRANT 


4 


binary 


OUXBJBR 


Step transaction residency ttime, in 1024-microsecond 
units. That is the amount of time the transaction was in 
real storage. 


+42 


TIVRECLM 


4 


binary 


OUSBPREC + 
OUXBPREC 


Number of reclaims for this step 


+46 


TIVRCLAM 


4 


binary 


OUSBVAMR + 
OUXBVAMR 


Number of VIO reclaims for this step 


+50 


TIVCPGIN 


4 


binary 


OUSBCAPI + 
OUXBCAPI 


Number of common area page-ins for this step 


+54 


TIVCRECL 


4 


binary 


OUSBCAPR + 
OUXBCAPR 


Number of common area reclaims for this step 


+58 


TIVPGSTL 


4 


binary 


OUSBSTCT + 
OUXBSTCT 


Number of pages stolen from the storage for this step 


+62 


TIVPGSEC 


8 


binary 


OUCBPSS 


Number of page seconds for this step, in page millisecond 
units. Calculated as: the number of pages used by this 
step times the execution time it held that number of pages. 
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Record Type 35 - LOGOFF 



Record type 35 is written by IEFTB722 when a logoff process is completed. Its 
length is 1 1 7 bytes plus the length of the job accounting fields. 

This record identifies the job by job name, logoff time and date, logon time and 
date, user identification, and performance group number. If accounting numbers 
(which can be alphameric) were specified on the JOB card, they are included. 

This record also contains operating information such as number of TPUTs issued, 
number of TGETs satisfied, termination status, storage protect key, job service, 
transaction active time, number of transactions, and job CPU time. 

Note: For more information on CPU time, see Appendix C. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








TLGRFLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


TLGRCDTY 


1 


binary 


internal 


Record type 


2 


2 


TLGRCDTS 


4 


binary 


SVC 11 (Set by 
IEFTB722) 


Logoff time, in hundredths of a second 


6 


6 


TLGRCDTE 


4 


packed 


SVC 1 1 (Set by 
IEFTB722) 


Logoff date, in the form 00YYDDDF where F is the sign 


10 


A 


TLGCPUID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


TLGUIF 


8 


EBCDIC 


JMRJOB 


Job name 


22 


16 


TLGONTME 


4 


binary 


JMRENTRY 


Logon time, in hundredths of a second 


26 


1A 


TLGONDTE 


4 


packed 


JMREDATE 


Logon date, in the form 00YYDDDF where F is the sign 


30 


1E 


TLGUDATA 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


TLGSTPCT 


1 


binary 


JMRSTEP 


Number of steps in session. (This field always equals 1.) 


39 


27 


TLGCRTME 


4 


binary 




Reserved 


43 


2B 


TLGOUTCT 


4 


binary 


TCTLOUT 


Number of lines of terminal output, that is, number of 
TPUTs issued 


47 


2F 


TLGINCT 


4 


binary 


TCTLIN 


Number of lines of terminal input, that is, number of 
TGETs satisfied 


51 


33 


TLGSTAT 


2 


binary 


TCBCMPC 


Job completion code: 

X'Occc' indicates system ABEND where ccc is the system 

ABEND code 

(See OS/VS Message Library: VS2 System Codes.) 

X'8ccc' indicates user ABEND where ccc is the user 

ABEND code. 

X'nnnn' indicates normal completion where nnnn is the 

contents of the two low-order bytes in register 15 at 

termination. 

X'0000' indicates normal job completion with return 
code of 0. 

Use this field in conjunction with the job termination 
indicator field (offset 62). 
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Offsets 


Name 


Length 


Format 


Source 


Description 




53 


35 


TLGPRI 


1 


binary 


JCTJPRTY 


Logon priority. This field normally equals the user-assigned 
priority of 0-13, but if the job fails while being scheduled, 
this field equals 14 (taken from JOB card) 




54 


36 


TLGNQTME 


4 


binary 


JMRDRSTP 


Logon enqueue time, in hundredths of a second 




58 


3A 


TLGNQDTE 


4 


packed 


JMRDRSTP + 4 


Logon enqueue date, in the form 00YYDDDF where F 
is the sign 




62 


3E 


TLGTRMI 


1 


binary 


JCTJMRCL 
JCTJMRCL 


Job termination indicator 

Bit Meaning When Set 
0-1 Reserved 

2 Canceled at exit I EFUJI 

3 Canceled at exit IEFUSI 
4-7 Reserved 




63 


3F 


TLGOUTCL 


1 


binary 




Reserved 




64 


40 


TLGTRANT 


4 


binary 


OUXBJBR 


Job transaction residency time, in 1024-microsecond units. 
That is the total amount of time all transactions were in 
real storage. 2 


1 


68 


44 


TLGRVC 


4 


binary 




Reserved 




72 


48 


TLGSPK 


1 


binary 


TCBPKF 


Storage protect key, in the form xxxxOOOO where xxxx 
is the key 




73 


49 


TLGSRBT 


3 


binary 


SCTSRBT 


Job CPU time under SRBs, in hundredths of a second. This 
field includes the CPU time for various supervisory 
routines that are dispatched via SRB : locking routines, 
page resolution, swap control, cross-memory 
communications (WAIT, POST, I/O POST), and TQE 
scheduling. 1 




76 


4C 


TLGTJS 


4 


binary 


OUXBJBS + 
OUXBTRS 


Job service, in service units 2 




80 


50 


TLGTTAT 


4 


binary 


OUXBJBT + 
OUXBTRT 


Job transaction active time, in 1024-microsecond units 2 


1 


84 


54 


TLGNTSN 


4 


binary 


OUXBTRC 


Number of transactions 2 




88 


58 


TLGPGNO 


2 


binary 


OUCBNPG 


Performance group number (taken from PERFORM= 
parameter on JOB card) 2 


'£,■ 


90 


5A 


TLGRV2 


2 


binary 




Reserved 




92 


5C 


TLGVAR 


1 


binary 


ACTLEN (in JCT) 


Length of rest of record, excluding this field ' ; 




93 


5D 


TLGRVB 


20 


EBCDIC 




Reserved " r 




113 


71 


TLGCPUTM 


3 


binary 


ACTJTIME (in JCT) 


Job CPU time under TCBs, in hundredths of a second. This 
field includes the CPU time for all tasks that are dispatched 
via TCBs below the level of RCT. 1 


I 


116 


74 


TLGNBRAC 


1 


binary 


ACTJNFLD (in JCT) 


Number of accounting fields 


"N 


117 


75 


TLGACFLD 


variable 


EBCDIC 


JOB statement 


Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) 
followed by the field (EBCDIC). A zero indicates an 
omitted field. 





l|f TIME=1440 is specified on the JOB statement, all timing for the job is eliminated. If TIME=1440 
is specified on an EXEC statement and a job time limit is not specified on the JOB statement, all 
timing for that job step is eliminated. For more information, see the IEFUTL exit. 

CPU time may not be constant between different runs of the same job. For more information on 
CPU time, see Appendix C. 

2 For more information on service, transaction active time, and performance group number, see 
OS/VS2 System Programming Library: Initialization and Tuning Guide. Note that the service, 
active time, and residency time may have been accumulated under different performance group numbers. 
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Record Type 40 - Dynamic DD 

Record type 40 is written by IEFDB4F9 when an unallocation, concatenation, or 
deconcatenation request is processed. For an unallocation request, this record 
contains a device entry only for the data set unallocated. For a concatenation or 
deconcatenation request, this record contains a device entry for each DD entry in 
the TCTIOT. Its length is 62 bytes plus eight bytes for each device entry. 

Record type 40 contains the job log identification, user identification, step 
number, functional indicator, and device entries. Each device entry consists of the 
device class, unit type, channel address, unit address, and EXCP count for the data 
set. 



Note: For more information on EXCP count and CPU time, see Appendixes 
B and C, respectively. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








TDDRFLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


TDDRCDTY 


1 


binary 


internal 


Record type 


2 


2 


TDDRCDTS 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


TDDRCDTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


TDDCPUID 


4 


EBCDIC 


JMRCPUID 


System identification (taken from SID parameter) 


14 


E 


TDDUIF 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


TDDONTME 


4 


binary 


JMRENTRY 


Logon time, in hundredths of a second (If background job, 
this field contains the time the reader recognized the JOB 
card.} 1 


26 


1A 


TDDONDTE 


4 


packed 


JMREDATE 


Logon date, in the form 00YYDDDF where F is the sign. 
(If background job, this field contains the date the reader 
recognized the JOB card.) 1 


30 


1E 


TDDUDATA 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


TDDINVSQ 


1 


binary 


JMRSTEP 


Step number (first step = 1 , etc.) 


39 


27 


TDDFLG 


1 


binary 


internal 


Functional indicator 

Value Meaning 

2 Unallocation 

3 Concatenation 

4 Deconcatenation 


40 


28 


TDDRIN 


2 


binary 


TCTIEX 


Record indicator 

Bit Meaning When Set 

0-6 Reserved 

7 EXCP count may be wrong 2 

8-1 5 Reserved 



1 The job name and the time and date that the reader recognized the JOB card for this 
job constitute the job log identification. 

2 lf a GETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, 
only the existing data sets are counted. If the functional recovery routine is entered, EXCP 
counting for the step is discontinued and no device entries are produced. If ADDRSPC=REAL 
is specified, the EXCP count does not include PCIs. For more information on EXCP count, 
see Appendix B. 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


42 


2A 


TDDRVA 


18 


binary 




Reserved 


60 


3C 


TDDVAR 


2 


binary 


internal 


Length of device entry portion of this record. Calculated as: 
(8 times the number of devices) + 2 


For each device, there is an ejght-byte entry with the following format: 3 




+0 




TDDDEVC 


1 


binary 


UCBTBYT3 


Device class 


+1 




TDDUTYP 


1 


binary 


UCBTBYT4 


Unit type 


+2 




TDDCUAD 


1 


binary 


UCBCHA 


Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 


+3 






1 


binary 


UCBUA 


Unit address 


+4 




TDDNEXCP 


4 


binary 


TCTDCTR 


EXCP count (see offset 40) 2 



2 lf a GETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, only 
the existing data sets are counted. If the functional recovery routine is entered, EXCP counting for 
the step is discontinued and no device entries are produced. If ADDRSPC=REAL is specified, the 
EXCP count does not include PCIs. For more information on EXCP count, see Appendix B. 

3 The device entry is zero when the DD entry is TERM, DUMMY, or unallocated DYNAM. (A DD 
DUMMY entry also results when a forward reference to a DD statement having that DD name is 
not found.) Entries for virtual I/O data sets are zero for class and type, and X'OFFF' for 
channel/unit address. 
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Record Type 43 JES2 Start 



Record type 43 is written by HASPINIT when an S JES2 command (to start JES2) 
is issued, and by HASPMISC when a $E SYS command (to reclaim the job processing 
that was being done on the named system in a Multi-Access Spool complex) 
is issued. This record contains a start/warm start indicator, JES2 start options, and 
the identification of the system whose job processing is to be reclaimed. Its length 
is 28 bytes. 

The format is : 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF43FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF43RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF43TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF43DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF43SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF43SBS 


2 


binary 


internal 


Subsystem identification — X'0002' signifies JES2 


16 


10 


SMF43RSV 


2 


binary 




Reserved 


18 


12 


SMF43LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF43RV1 


2 


binary 




Reserved 


22 


16 


SMF43RST 


1 


binary 


internal 


Start/warm start indicator 

Bit Meaning When Set 

If 0, record written for S JES2 command. 

If 1, record written for $E SYS command 

(see offset 24). 
1-7 Reserved 


23 


17 


SMF430PT 


1 


binary 


$OPTSTAT (in HCT) 


JES2 start options. (This field is zero for $E SYS 
command.) 

Bit Meaning When Set 

Format the spool 

1 Cold start 

2 Request automatic initiator 

3 List replacement card option 
4-7 Reserved 


24 


18 


SMF43EID 


4 


EBCDIC 


QSESID 


If $E SYS command, identification of system whose job 
processing is to be reclaimed (see offset 22). 
If "S JES2 command, zero. 
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Record Type 43 - JES3 Start 



Record type 43 is written by IATINTK during JLS3 initialization. This record 
contains an indicator for the type of JHS3 start. J I S3 initialization deck origin 
type and contents, and J I: S3 procedure name. Its length is 38 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF43FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF43RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF43TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 

SMF buffer 


6 


6 


SMF43DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF43SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF43SBS 


2 


binary 


internal 


Subsystem identification - X'0005' signifies JES3 


16 


10 


SMF43RSV 


2 


binary 




Reserved 


18 


12 


SMF43LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF43RV1 


2 


binary 




Reserved 


22 


16 


SMF43RST 


1 


binary 


Set by IATINGL 


JES3 start record indicator (taken from operator's response 
to WTOR macro) 

Bit Meaning When Set 

Cold start 

1 Warm start 

2 Hot start 

3 Start is with JES3 queue analysis 

4 JES3 global processor. This bit is always set if start 

is a cold start or warm start. 

5 J ES3 local processor. This bit is always set if start 

is a hot start. 

6 Reserved 

7 Dynamic system interchange was invoked by 

operator to convert a local processor to the global 
processor. Bits 2 and 4 will also be set. 


23 


17 


SMF43RV2 


2 


binary 




Reserved 


25 


19 


SMF43NMU 


1 


EBCDIC 


Set by IATINGL 


JES3 initialization deck origin type (taken from operator's 
response to WTOR macro) 


26 


1A 


SMF430RG 


8 


EBCDIC 


Set by IATINGL 


JES3 initialization deck origin location (taken from 
operator's response to WTOR macro) 

Type Contents Location 
N Member name JCL in JES3 procedure 
M Member name Data set in JES3 procedure 
U Unit address Unit at specified address 


34 


22 


SMF43PJ3 


4 


EBCDIC 


JESPJESN in JESCT 


JES3 procedure name 
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Record Type 45 - JES2 Withdrawal 

Record type 45 is written by HASPNUC when a $P JES2 command (to withdraw 
JES2 from the system) is issued. It is also written at the abnormal termination of 
JES2 if JES2 regains control long enough to write the record. This record contains 
a termination indicator and JES2 completion code. Its length is 24 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF45FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF45RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF45TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF45DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF45SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF45SBS 


2 


binary 


internal 


Subsystem identification — X'0002' signifies JES2 


16 


10 


SMF45RSV 


2 


binary 




Reserved 


18 


12 


SMF45LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF45IND 


2 


binary 


internal 


Termination indicator 

Bit Meaning When Set 

If 0, record written for $P JES2 command (JES2 

withdrawal). 

If 1, record written for abnormal JES2 termination. 
1-15 Reserved 


22 


16 


SMF45JCC 


2 


binary 


internal 


JES2 completion code 
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Record Type 45 - JES3 Stop 



Record type 45 is written by IATINTK during JES3 termination. This record 
contains an indicator for the type of JES3 stop and the JES3 completion code. 
Its length is 26 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF45FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF45RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF45TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF45DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF45SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF45SBS 


2 


binary 


internal 


Subsystem identification — X'0005' signifies JES3 


16 


10 


SMF45RSV 


2 


binary 




Reserved 


18 


12 


SMF45LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF45FG1 


1 


binary 


Set by IATNUC 

Set by IATYIK 
macro 


JES3 stop record indicator 
Bit Meaning When Set 

JES3 abnormally terminated (taken from completion 

code in ECB) 

1 Dynamic system interchange was invoked by 

operator to convert a local processor to the 
global processor 
2-7 Reserved 


21 


15 


SMF45J3C 


3 


binary 


Set by IATNUC 


JES3 completion code (taken from completion code in 
ECB) where bits 0-1 1 represent a system code and bits 
12-23 represent a user code. Note that the JES3 
completion code, as recorded on the operator's console, 
is always S 2FB. 


24 


18 


SMF45RV1 


2 


binary 




Reserved 
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Record Type 47 - JES2 SIGNON/Start Line 

Record type 47 is written by HASPRTAM when (1) a $S LNEn command (to 
start a line) is issued, (2) a $E LNEn command (to restart a line) is issued, and (3) 
a remote user signs on. This record contains a record indicator, remote name, line 
name, password, and message text. Its length is 48 bytes for a $S LNEn command 
and 86 bytes for a SIGNON record. 

The format is : 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF47FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF47RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF47TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF47DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF47SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF47SBS 


2 


binary 


internal 


Subsystem identification — X'0002' signifies JES2 


16 


10 


SMF47RSV 


2 


binary 




Reserved 


18 


12 


SMF47LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF47EVT 


2 


binary 


internal 


Record indicator 

Bit Meaning When Set 
0-13 Reserved 

14 Record written for $S LNEn command 

15 Record written for SIGNON 


Iden 
22 


tificati 
16 


on Section: 
SMF47LN1 


2 


binary 


internal 


Length of identification section, including this field 


24 


18 


SMF47RMT 


8 


EBCDIC 


RATNAME 


Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 


32 


20 


SMF47LIN 


8 


EBCDIC 


DCTDEVN 


Line name 


40 


28 


SMF47PSW 


8 


EBCDIC 


MDCTPSWD (in DCT) 


Password 


The1 
Mess 
48 


Followi 

age Sec 

30 


ng fields apply w 
tion: 

SMF47LN2 


len a rem 
2 


ote user si< 
binary 


jnson: 
internal 


Length of rest of record, including this field 


50 


32 


SMF47MSG 


36 


EBCDIC 


SIGNON record 


Message text. This field includes columns 35-70 of the 
SIGNON card image. 
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Record Type 47 - JES3 SIGNON/Start Line 

Record type 47 is written by IATRJM3 when (1) an RJP line is started, and (2) 
a remote user signs on. This record contains a record indicator, remote name, 
line name, password, and SIGNON message text. Its length is 48 bytes for a 
started line and 86 bytes for a SIGNON record. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF47FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF47RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF47TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF47DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF47SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF47SBS 


2 


binary 


internal 


Subsystem identification — X'0005' signifies JES3 


16 


10 


SMF47RSV 


2 


binary 




Reserved 


18 


12 


SMF47LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF47EVT 


2 


binary 


IATRJM1 
IATRJM3 


Record indicator 

Bit Meaning When Set 

0-1 3 Reserved 

14 Record written for started line 

15 Record written for SIGNON 


Iden 
22 


tificatic 
16 


n Section: 

SMF47LN1 


2 


binary 


internal 


Length of identification section including this field 


24 


18 


SMF47RMT 


8 


EBCDIC 


IATRJM1 for line, 
IATRJM3 for 
SIGNON 


Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 


32 


20 


SMF47LIN 


8 


EBCDIC 


IATRJM1 for line, 

IATRJM3for 

SIGNON 


Line name 


40 


28 


SMF47PSW 


8 


EBCDIC 


SIGNON record 


Password 


The 

Mess 

48 


follOWl 

age Sec 
30 


rtg fields apply wr 
tion: 

SMF47LN2 


en a rerr 
2 


ote user sig 
binary 


ns on: 
internal 


Length of message section, including this field 


50 


32 


SMF47MSG 


36 


EBCDIC 


SIGNON record 


Message text. This field includes columns 35-70 of the 
SIGNON card image. 
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Record Type 48 - JES2 SIGNOFF/Stop Line 

Record type 48 is written by HASPRTAM when (1) a $P LNEn command 
(to stop a line) is issued, (2) a $E LNEn command (to restart a line) is issued, and 
(3) a remote user signs off. This record contains a record indicator, remote name, 
line name, password, line adapter address, and the number of EXCPs, negative 
acknowledgements to write text, data checks to read text, and time outs to read 
text. Its length is 71 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF48FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF48RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF48TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF48DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF48SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF48SBS 


2 


binary 


internal 


Subsystem identification — X'0002' signifies JES2 


16 


10 


SMF48RSV 


2 


binary 




Reserved 


18 


12 


SMF48LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF48EVT 


2 


binary 


internal 


Record indicator 

Bit Meaning When Set 
0-1 3 Reserved 

14 Record written for $P LNEn command 

15 Record written for SIGNOFF 


22 


16 


SMF48RV1 


2 


binary 




Reserved 


24 


18 


SMF48RMT 


8 


EBCDIC 


RATNAME 


Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 


32 


20 


SMF48LIN 


8 


EBCDIC 


DCTDEVN 


Line name 


40 


28 


SMF48PSW 


8 


EBCDIC 


MDCTPSWD 
(in DCT) 


Password 


48 


30 


SMF48IO 


4 


binary 


MDCTSXCP or 
MDCTXCP 1 


EXCP count 


52 


34 


SMF48NAK 


4 


binary 


MDCTSNAK 
or MDCTNAK 1 


Number of negative acknowledgements to write text 


56 


38 


SMF48DCK 


4 


binary 


MDCTSDCK 
or MDCTDCK 1 


Number of data checks to read text 


60 


3C 


SMF480UT 


4 


binary 


MDCTSTO 
or MDCTTO 1 


Number of time outs to read text 


64 


40 


SMF48ERR 


4 


binary 


MDCTSREM 
orMDCTREM 1 


Sum of all other line errors 


68 


44 


SMF48LAA 


3 


EBCDIC 


UCBNAME 


Line adapter address 



2 The field names beginning with MDCTS are for SIGNOFF and contain session totals; the 
other fields are for $P LNEn commands and contain connection totals. 
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Record Type 48 - JES3 SIGNOFF/Stop Line 

Record type 48 is written by IATRJM3 when (1) an RJP line is stopped, and (2) 
a remote user signs off. This record contains a record indicator, remote name, 
line name, password, line adapter address, and the number of EXCPs, line errors, 
time outs, NAKs, command rejects, interventions required, bus-out checks, 
equipment checks, data checks, data overruns, and lost datas. Its length is 79 bytes. 

Note: The statistics in this record are accumulated for the line from SIGNON to 
SIGNOFF. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF48FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF48RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF48TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF48DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF48SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF48SBS 


2 


binary 


internal 


Subsystem identification — X'0005' signifies JES3 


16 


10 


SMF48RSV 


2 


binary 




Reserved 


18 


12 


SMF48LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF48EVT 


2 


binary 


IATRJM4 
IATRJM4 


Record indicator 

Bit Meaning When Set 

0-13 Reserved 

14 Record written for stopped line 

15 Record written for SIGNOFF 


22 


16 


SMF48RV1 


2 


binary 




Reserved 


24 


18 


SMF48RMT 


8 


EBCDIC 


IATRJM4 


Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) • 


32 


20 


SMF48LIN 


8 


EBCDIC 


IATRJM4 


Line name 


40 


28 


SMF48PSW 


8 


EBCDIC 


IATRJM4 


Password 


48 


30 


SMF48TRN 


4 


binary 


IATRJM4 


EXCP count 


52 


34 


SMF48ERS 


4 


binary 


IATRJM4 


N umber of line errors 


56 


38 


SMF48TOT 


2 


binary 


IATRJM4 


Number of time outs to read text 


58 


3A 


SMF48NKS 


2 


binary 


IATRJM4 


Number of negative acknowledgements to write text 


60 


3C 


SMF48S0 




binary 


IATRJM4 


Number of command rejects 


61 


3D 


SMF48S1 




binary 


IATRJM4 


Number of interventions required 


62 


3E 


SMF48S2 




binary 


IATRJM4 


Number of bus-out checks 


63 


3F 


SMF48S3 




binary 


IATRJM4 


Number of equipment checks 


64 


40 


SMF48S4 




binary 


IATRJM4 


Number of data checks 


65 


41 


SMF48S5 




binary 


IATRJM4 


Number of data overruns 


66 


42 


SMF48S6 




binary 


IATRJM4 


Number of lost datas 


67 


43 


SMF48USR 


9 


binary 




Reserved 


76 


4C 


SMF48ADP 


3 


EBCDIC 


IATRJM4 


Line adapter address 
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Record Type 49 - JES2 Integrity 

Record type 49 is written by HASPRTAM when a remote user attempts to sign on 
with an invalid password. This record is the same as record type 47 except the 
password is invalid. It contains a record indicator, remote name, line name, invalid 
password, and message text. Its length is 86 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF49FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF49RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF49TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF49DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF49SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF49SBS 


2 


binary 


internal 


Subsystem identification — X'0002' signifies JES2 


16 


10 


SMF49RSV 


2 


binary 




Reserved 


18 


12 


SMF49LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF49EVT 


2 


binary 


internal 


Record indicator 

Bit Meaning When Set 

0-14 Reserved 

15 Record written for SIGNON 


Iden 
22 


tificati* 

16 


»n Section: 

SMF49LN1 


2 


binary 


internal 


Length of identification section, including this field 


24 


18 


SMF49RMT 


8 


EBCDIC 


RATNAME 


Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 


32 


20 


SMF49LIN 


8 


EBCDIC 


DCTDEVN 


Line name 


40 


28 


SMF49PSW 


8 


EBCDIC 


SIGNON record 


Invalid password 


Men 
48 


lageSm 

30 


stion: 

SMF49LN2 


2 


binary 


internal 


Length of rest of record, including this field 


50 


32 


SMF49MSG 


36 


EBCDIC 


SIGNON record 


Message text. This field includes columns 35-70 of the 
SIGNON card image. 
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VS2.03.812 

Record Type 49 — JES3 Integrity 

Record type 49 is written by IATRJM3 when a remote user attempts to sign on 
with an invalid password. This record is the same as record type 47 except the 
password is invalid. It contains a record indicator, remote name, line name, invalid 
password, and S1GNON message text. Its length is 86 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF49FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF49RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF49TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF49DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF49SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF49SBS 


2 


binary 


internal 


Subsystem identification — X'0005' signifies JES3 


16 


10 


SMF49RSV 


2 


binary 




Reserved 


18 


12 


SMF49LRR 


2 


binary 


internal 


Length of rest of record, excluding this field 


20 


14 


SMF49EVT 


2 


binary 


IATRJM3 


Record indicator 
Value Meaning 

1 Terminal, not defined 

2 Invalid password 

3 Line already signed on 

4 Terminal already signed on 


Ident 
22 


ificatic 
16 


n Section: 

SMF49LN1 


2 


binary 


internal 


Length of identification section, including this field 


24 


18 


SMF49RMT 


8 


EBCDIC 


IATRJM3 


Remote name (This field is filled in only if a remote 
terminal is connected to this line.) 


32 


20 


SMF49LIN 


8 


EBCDIC 


IATRJM3 


Line name 


40 


28 


SMF49PSW 


8 


EBCDIC 


SIGNON record 


Invalid password 


Mess: 
48 


ige Sec 

30 


tion: 

SMF49LN2 


2 


binary 


internal 


Length of message section, including this field 


50 


32 


SMF49MSG 


36 


EBCDIC 


SIGNON record 


Message text. This field includes columns 35-70 of the 
SIGNON card image. 
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Record Type 62 - VSAM Component or Cluster Opened 

Record type 62 is written by IDA01 92 A and IDA01 92S at the successful or 
unsuccessful opening of a VSAM component or cluster. Its length is 138 bytes 
plus ten bytes for each volume listed. 

Record type 62 identifies the VSAM component or cluster and indicates whether 
it was successfully opened. It names the VSAM catalog in which the object is 
defined and the volumes on which the catalog and object are stored. It also 
identifies the job that issued the OPEN macro by job log identification and user 
identification. 

Note: This record is not generated when a system task issues the OPEN macro. 

The format is: 



' Offsets 


Name 


Length 


Format 


Source 


Description 








SMF62FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF62RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF62TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF62DTE 


4 


packed 


SVG 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF62SIO 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF62JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF62RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF62RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign 1 


30 


1E 


SMF62UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF62IND 


4 


binary 


SetbylDA0192A 
and passed to 
IDA0192S in 
parameter list 


Open status indicator 
Bit Meaning When Set 

Component or cluster was successfully opened 

1 Security violation, that is, invalid password 
2-31 Reserved 


42 


2A 


SMF62CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of the catalog in which the component or cluster is 
defined 


86 


56 


SMF62CVS 


6 


EBCDIC 


UCBVOLI 


Volume serial number of the volume containing the catalog 


92 


5C 


SMF62DNM 


44 


EBCDIC 


JFCBDDNM 


Name of the component or cluster being opened 


136 


88 


SMF62VCT 


2 


binary 


OPEN routine 
calculates from 
VMT entries 


Number of online volumes containing the component or 
cluster. (This field is also the number of ten-byte fields 
that list the volumes.) 


Fore 
+0 

+6 


achor 


iline volume, ther 
SMF62VSR 

SMF62DTY 


e is a ten 
6 

4 


•byte entry 
EBCDIC 

binary 


with the following f< 
VMTVLSER 

UCBTYP 


srmat: 

Volume serial number of the volume containing the 
component or cluster 

Unit type of the volume containing the component or 
cluster 



2 The job name and the- time and date that the reader recognized the JOB card for this 
job constitute the job log identification. 
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Record Type 63 - VSAM Entry Defined 

Record type 63 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) (1) is defined by the 
DEFINE Access Method Service command, (2) is altered with new space allocation 
information (that is, when the VSAM end-of-volume (EOV) routine extends the 
entry's object), and (3) is changed by the ALTER Access Method Services 
command. One record type 63 is written for each newly created or altered entry. 
Its length is 132 bytes plus the length of the catalog records required to describe the 
entry. 

Record type 63 identifies the catalog in which the object is defined, gives the 
catalog record for the newly defined object, and, for an alteration, gives the parts 
of the old catalog record before they were altered. It identifies the job by job log 
identification and user identification. 

Notes: 

1 . The IEHUCAT utility program uses SMF record types 63 and 67 to update an OS 
catalog to the level of a VSAM catalog. For more information on IEHUCAT, see 
OS I VS Utilities. 

2. The length of this record can be from 1000 to 4000 bytes or more, depending 
upon the sizes of the new and old catalog records (offsets 40 and 42, respectively). 
If this record is to be written to the SMF data set, be sure to include the sizes of 
these catalog records when estimating the additional storage required for the SMF 
buffer and the SMF data sets. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF63FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF63RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF63TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF63DTE 


4 


packed 


SVC 83 


Date record wa« moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF63SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF63JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF63RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF63RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF63UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 1 


38 


26 


SMF63FDT 


1 


binary 


VSAM catalog 
record entry type 


Record creator/entry type indicator 
Bit Meaning When Set 

New definition 

1 Altered definition 
2-5 Reserved 

6 Path defined or altered 

7 Alternate index defined or altered 



1 The job name and the time and date that the reader recognized the JOB card for this job constitute 
the job log identification. If a system task caused the record to be written, the job-name and user- 
identification fields contain blanks and the time and date fields contain zeros. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


39 


27 


SMF63TYP 


1 


binary 


VSAM catalog 
record entry type 


Entry type indicator 
Bit Meaning When Set 

VSAM cluster 

1 VSAM data component 

2 VSAM index component 

3 VSAM catalog 

4 Non-VSAM data set 

5 Generation data group 

6 Alias 

7 Reserved 


40 


28 


SMF63NSZ 


2 


binary 


internal 


Size of new catalog record. (Be sure to include the contents 
of this field when estimating the additional storage 
required by SMF.) 2 


42 


2A 


SMF630SZ 


2 


binary 


internal 


Size of old catalog record. This field contains the size of 
the old records before they were altered. (Be sure to 
include the contents of this field when estimating the 
additional storage required by SMF.) 2 


44 


2C 


SMF63CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of catalog in which the entry is defined 


88 


58 


SMF63ENM 


44 


EBCDIC 


Name field of VSAM 
catalog record 


Entry name 


132 


84 


SMF63NCR 


variable 


binary 


VSAM catalog entry 
records 


New catalog record followed by old catalog record. 2 
For the new catalog record, the complete new entry is 
recorded. For the old catalog record, this field contains 
only those old records that were altered; it shows what 
these records were before they were altered. 



2 A VSAM catalog record is contained in one or more physical 
catalog records. Offsets 40 and 42 are the sums of the sizes 
of the physical catalog records that constitute the total logical 
VSAM catalog record. 



SMF Records 127 



Record Type 64 — VSAM Component or Cluster Status 

Record type 64 is written when (1) a VSAM component or cluster is closed, (2) 
VSAM must switch to another volume to continue to read or write, and (3) there 
is no more space available for VSAM to continue processing. If a cluster is closed, 
one record is written for each component in the cluster. This record is written by 
IDA0192S, IDA0200B, IDA023 1 B, and IDA0557A. Its length is 250 bytes plus 
26 bytes for each extent. 

Record type 64 indicates why the record was created (a component was closed, 
another volume was switched to, or no additional space was available). It describes 
the device and volume(s) on which the object is stored, and gives the extents of the 
object on the volume(s). It also gives statistics about various processing events that 
have occurred since the object was defined, such as the number of records in the 
data component, the number of records that were inserted, and the number of 
control intervals that were split. This record identifies the job by job log 
identification and user identification. 

Notes: 

1 . This record is not generated for system tasks. 

2. For more information on EXCP count, see Appendix B. 



128 OS/VS2 System Management Facilities (SMF) 



The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF64FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5' Reserved 

6 VS2 

7 VS1 


1 


1 


SMF64RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF64TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to SMF 
buffer 


6 


6 


SMF64DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF64SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF64JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF64RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the JOB 
card for this job 1 


26 


1A 


SMF64RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF64UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 


38 


26 


SMF64RIN 


1 


binary 


internal 


Situation indicator 

Bit Meaning When Set 

Component closed 

1 Volume switched 

2 No space available 
3-7 Reserved 


39 


27 


SMF64DTY 


1 


binary 


AMBTYPE 


Indicator of component being processed 
Bit Meaning When Set 

Data component 

1 Index component 
2-7 Reserved 


40 


28 


SMF64CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of the catalog in which the component is defined 


84 


54 


SMF64DNM 


44 


EBCDIC 


VSAM catalog 
(ENTNAME) 


Name of the component being processed 


128 


80 


SMF64NTR 


2 


binary 


VSAM catalog 
(PRIMSPACfor 
primary allocation; 
SCONSPAC for 
secondary allocation) 


Number of tracks that were requested but could not be 
allocated 


130 


82 


SMF64CHR 


4 


binary 


ARDHRBA 
(inARDB) 


Highest used relative byte address (RBA) of the component 


134 


86 


SMF64ESL 


2 


binary 


DEBNMEXT * 26 


Length of extent entry portion of record, excluding this field 


Fore 
+0 

+4 

+8 
+14 

+16 


ach ex 


tent, there is a 2 
SMF64FCC 

SMF64TCC 

SMF64VSN 
SMF64CUU 

SMF64IND 


6-byte em 
4 

4 

6 
1 

1 
2 


try with th 
binary 

binary 

EBCDIC 
binary 

binary 
binary 


e following format: 
DEBSTRCC 

DEBENDCC 

UCBVOLI 
UCBCHA 

UCBUA 
internal 


Beginning cylinder and track, in the form CCHH where CC 
is the cylinder number and HH is the track number 

Ending cylinder and track, in the form CCHH where CC is 
the cylinder number and HH is the track number 

Volume serial number of the volume containing the extent 
Channel address. (A mass storage volume is indicated when 
the high-order bit of this field is on.) 2 
Unit address 2 
Spindle identification 



J The job name and the time and date that the reader recognized the JOB card for this 
job constitute the job log identification. 

2 These fields are zero for DD # , DD DATA, DD DUMMY and spooled data sets. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


+18 




SMF64UTY 


4 


binary 


UCBTYP 


Unit type 


+22 




SMF64RV1 


4 


binary 




Reserved 


Statistics Section: 3 

Accumulative Statistics from Creation Until the Current OPEN: 




+0 




SMF64SLN 


4 


binary 


internal 


Length of the statistics section, including this field 


+4 




SMF64NIL 


4 


binary 


AMDNIL 


Number of levels in the index 


+8 




SMF64NEX 


4 


binary 


AMDNEXT 


Number of extents 


+12 




SMF64NLR 


4 


binary 


AMDNLR 


Number of records in the component 


+16 




SMF64NDE 


4 


binary 


AMDDELR 


Number of records that were deleted from the component 


+20 




SMF64NIN 


4 


binary 


AMDIREC 


Number of records that were inserted into the component 


+24 




SMF64NUP 


4 


binary 


AMDUPR 


Number of records that were updated in the component 


+28 




SMF64NRE 


4 


binary 


AMDRETR 


Number of records that were retrieved from the component 


+32 




SMF64NFS 


4 


binary 


AMDFSCA 


Number of unused control intervals in the component 


+36 




SMF64NCS 


4 


binary 


AMDNCIS 


Number of control intervals that were split in the 
component 


+40 




SMF64NAS 


4 


binary 


AMDNCAS 


Number of control areas that were split in the component 


+44 




SMF64NEP 


4 


binary 


AMDEXCP 


Number of EXCPs. (For more information about EXCP 
count, see Appendix B.) 


Change in Statistics from OP 


EN to Ti 


me of EOV and CLOSE: 




+48 




SMF64DIL 


4 


binary 


AMDNIL 


Change in number of levels in the index 


+52 




SMF64DEX 


4 


binary 


AMDNEXT 


Change in number of extents 


+56 




SMF64DLR 


4 


binary 


AMDNLR 


Change in number of records in the component 


+60 




SMF64DDE 


4 


binary 


AMDDELR 


Change in number of records that were deleted from the 
component 


+64 




SMF64DIN 


4 


binary 


AMDIREC 


Change in number of records that were inserted into the 
component 


+68 




SMF64DUP 


4 


binary 


AMDUPR 


Change in number of records that were updated in the 
component 


+72 




SMF64DRE 


4 


binary 


AMDRETR 


Change in number of records that were retrieved from the 
component 


+76 




SMF64DFS 


4 


binary 


AMDFSCA 


Change in number of unused control intervals in the 
component. (This field may be negative.) 


+80 




SMF64DCS 


4 


binary 


AMDNCIS 


Change in number of control intervals that were split 
in the component 


+84 




SMF64DAS 


4 


binary 


AMDNCAS 


Change in number of control areas that were split in the 
component 


+88 




SMF64DEP 


4 


binary 


AMDEXCP 


Change in number of EXCPs. (For more information about 
EXCP count, see Appendix B.) 


Data Set Characteristics Sect 


ion: 








+92 




SMF64DBS 


4 


binary 


LPMBLKSZ 
(in IDALPMB) 


Physical block size 


+96 




SMF64DCI 


4 


binary 


AMDCINV 
(in AMDSB) 


Control interval size 


+100 




SMF64DLS 


4 


binary 


AMDLRECL 
(in AMDSB) 


Maximum logical record size 


+104 




SMF64DKL 


2 


binary 


AMDKEYLN 
(in AMDSB) 


Key length 


+106 




SMF64DDN 


8 


EBCDIC 


TIOEDDNM 


DD name. When the record is written for a VSAM catalog 
or catalog recovery area, this field may contain zeros. When 
the record is written for a volume switch or no space 
available condition, and the volume is associated with a 
concatenated TIOT entry, this field contains blanks. 



All the fields in this section are present and are taken from the AMDSB 
data area; inapplicable fields contain zeros. 
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Record Type 67 - VSAM Entry Deleted 

Record type 67 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is deleted. A type 63 
record is written for each entry affected by the DELETE Access Method Services 
command. For example, three records are written for an indexed cluster: one for 
the relationship between the components of the cluster, one for the data component, 
and one for the index component. Its length is 130 bytes plus the length of the 
catalog records required to describe the entry. 

Record type 67 identifies the deleted entry, the VSAM catalog in which the entry 
was defined, and the deleted catalog records. It identifies the job by job log 
identification and user identification. 

Notes: 

1 . The IEHUCAT utility program uses SMF record types 63 and 67 to update an OS 
catalog to the level of a VSAM catalog. For more information on IEHUCAT, see 
OS/VS Utilities. 

2. The length of this record can be from 1000 to 4000 bytes or more, depending 
upon the sizes of the catalog records that describe the entry (offset 1 28). If this 
record is to be written to the SMF data set, be sure to include the sizes of these 
catalog records when estimating the additional storage required for the SMF 
buffer and the SMF data sets. 



The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF67FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF67RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF67TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF67DTE 


4 


packed 


SVC 83 


Date record wa£ moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF67SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF67JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF67RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF67RSD 


4 


packed 


JM RE DATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF67UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 1 


38 


26 


SMF67FDT 


1 


binary 


VSAM catalog 
record entry type 


Record creator/entry type indicator 
Bit Meaning When Set 

Un cataloged 2 

1 Scratched 2 
2-5 Reserved 

6 Path deleted 
s 7 Alternate index deleted 



1 The job name and the time and date that the reader recognized the JOB card for this job constitute the job log 
identification. If a system task caused the record to be written, the job-name and user-identification fields contain 
blanks and the time and date fields contain zeros. 

2 Both indicators are set for VSAM component or cluster entries. For all other VSAM entries, only the uncataloged bit is set. 
For non-VSAM entries, the uncatalog bit is always set and the scratched bit is set if the physical non-VSAM space was deleted. 
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Offsets 


Name 


Length 


Format 


Source 


Description 


39 


27 


SMF67IOD 


1 


binary 


VSAM catalog 
record entry type 


Entry type indicator 
Bit Meaning When Set 

VSAM cluster 

1 VSAM data component 3 

2 VSAM index component 3 

3 VSAM catalog 

4 Non-VSAM data set 

5 Gen'eration data group 

6 Alias 

7 Reserved 


40 


28 


SMF67CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of catalog in which the entry was defined 


84 


54 


SMF67DEN 


44 


EBCDIC 


Name field of VSAM 
catalog record 


Entry name 


128 


80 


SMF67RSZ 


2 


binary 


internal 


Size of catalog record that defined the entry. 4 (Be sure to 
include the contents of this field when estimating the 
additional storage required by SMF.) 


130 


82 


SMF67CRC 


variable 


binary 


VSAM catalog 
entry records 


Catalog record 4 



A data or index component can only be deleted as one of the three catalog 
records deleted when a cluster is deleted. 

4 A VSAM catalog record is contained in one or more physical catalog records. 
Offset 1 28 is the sum of the sizes of the physical catalog records that constitute 
the total logical VSAM catalog record. 
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Record Type 68 - VSAM Entry Renamed 

Record type 68 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is renamed using the 
ALTER Access Method Services command. This record identifies the VSAM catalog 
in which the object is defined, and gives the old and new names for the object. It 
also identifies the job by job log identification and user identification. Its length is 
170 bytes. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF68FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1. 


1 


1 


SMF68RTY 


1 


binary 


internal 


Record type 


*2 


2 


SMF68TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF68DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF68SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


14 


E 


SMF68JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF68RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF68RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form 00YYDDDF where F is the sign 1 


30 


1E 


SMF68UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) l 


38 


26 


SMF68CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of catalog in which the entry is defined 


82 


52 


SMF680NM 


44 


EBCDIC 


Pointed to by 
CTGFVENT field in 
IE2CTGFV 
parameter list 


Old name of the entry. (AMS obtains this name from the 
ALTER command.) 


126 


7E 


SMF68NNM 


44 


EBCDIC 


Pointed to by 
CTGNEWNM field 
in IEZCTGPL 
parameter list 


New name of the entry. (AMS obtains this name from the 
ALTER command.) 



J The job name and the time and date that the reader recognized the JOB card for this job constitute 
the job log identification. If a system task caused the record to be written, the job-name and user- 
identification fields contain blanks and the time and date fields contain zeros. 
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Record Type 69 — VSAM Data Space Defined, Extended, or Deleted 

Record type 69 is written by IGGOCLBV when a VSAM data space is defined, 
extended, or deleted using the DEFINE or DELETE Access Method Services 
commands. Record type 69 is not written when a catalog or a unique data set is 
defined or deleted. Its length is 102 bytes. 

This record identifies the catalog in which the data space is defined and the 
volume on which it is (or was) allocated. It also gives the number of free data 
space extents and the amount of unallocated space on the affected volume after 
the definition, extension, or deletion. It identifies the job by job log identification 
and user identification. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF69FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 

0-5 Reserved 

6 VS2 

7 VS1 


1 


1 


SMF69RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF69TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF69DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF69SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


14 


E 


SMF69JBN 


8 


EBCDIC 


JMRJOB 


Job name 1 


22 


16 


SMF69RST 


4 


binary 


JMRENTRY 


Time, in hundredths of a second, reader recognized the 
JOB card for this job 1 


26 


1A 


SMF69RSD 


4 


packed 


JMREDATE 


Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign 1 


30 


1E 


SMF69UIF 


8 


EBCDIC 


JMRUSEID 


User identification (taken from common exit parameter 
area) 1 


38 


26 


SMF69CUU 


1 


binary 


UCBCHA 


Channel address 2 


39 


27 




1 


binary 


UCBUA 


Unit address 2 


40 


28 


SMF69IND 


2 


binary 


EXCP of sense data 


Spindle identification 


42 


2A 


SMF69NOS 


2 


binary 


VSAM catalog 
volume entry 


Number of free data space extents on the affected volume 
after the data space is defined, extended, or deleted 


44 


2C 


SMF69NUC 


2 


binary 


VSAM catalog 
volume entry 


Number of unallocated cylinders in all of the data spaces 
on the volume 


46 


2E 


SMF69NUT 


2 


binary 


VSAM catalog 
volume entry 


Number of unallocated tracks in all of the data spaces on 
the volume in addition to the number of unallocated 
cylinders 


48 


30 


SMF69LNC 


2 


binary 


VSAM catalog 
volume entry 


Number of cylinders in the largest continuous unallocated 
area in any data space on the volume 


50 


32 


SMF69LNT 


2 


binary 


VSAM catalog 
volume entry 


Number of tracks (in addition to the number of cylinders) 
in the largest continuous unallocated area in any data space 
on the volume 


52 


34 


SMF69CNM 


44 


EBCDIC 


CAXCNAM 

(in IGGCAXWA) 


Name of catalog in which the data space is defined 


96 


60 


SMF69VSR 


6 


EBCDIC 


Name field of VSAM 
catalog volume entry 


Volume serial number of the volume on which the data 
space is defined 



1 The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 

If a system task caused the -record to be written, the job-name and user-identification fields contain blanks and the time and 

date fields contain zeros. 
2 These fields are zero for DD*, DD DATA, DD DUMMY and spooled data sets. 
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Record Type 70 - CPU Activity 

Record type 70 is written by IRBMFDCP for each measurement interval and when 
MF/1 is terminated by a STOP operator command. It contains data that identifies 
each CPU, its status, and the amount of wait time that has taken place during an 
MF/1 reporting interval. Data is included for each CPU that has been online at the 
end of at least one reporting interval since MF/ 1 was started. Data is not included 
for CPUs that were offline at the end of the reporting interval, or that had any 
VARY activity during the interval. Its length is 52 bytes plus 16 bytes for each 
CPU entry. For more information about using this record, see OS/VS2 System 
Programming Library: Initialization and Tuning Guide. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF70FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF70RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF70TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF70DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF70SIO 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


Com 

14 


monCi 

E 


antral Data Sectioi 
SMF70SIZ 


i: 
2 


binary 


internal 


Size of common control data section 


16 


10 


SMF70IST 


4 


packed 


CVTTZ and STCK 
operand of TIME 
macro (Set by 
IRBMFDCP) 


Time MF/1 measurement interval started, in the form 
0HHMMSSF where F is the sign 


20 


14 


SMF70DAT 


4 


packed 


CVTDATE 

(Set by IRBMFDCP) 


Date MF/1 measurement interval started, in the form 
00YYDDDF where F is the sign 


24 


18 


SMF70INT 


4 


packed 


STCK operand of 
TIME macro (Set 
by IRBMFDCP) 


Duration of MF/1 measurement interval, in the form 
MMSSTTTF where F is the sign. (The end of the 
measurement interval is the sum of the recorded start time 
and this field.) 


28 


1C 


SMF70CYC 


2 


packed 




Reserved, in the form 000F 


30 


1E 


SMF70SUB 


6 


binary 




Reserved 


36 


24 


SMF70MFV 


2 


EBCDIC 


STSCMF1V 
(in STSCT) 


MF/1 version number 


38 


26 


SMF70RV1 


2 


binary 




* Reserved 


40 


28 


SMF70RLS 


4 


EBCDIC 


CVTRELNO 


Operating system release number and level, in the form 
NNLL 


CPU 

44 


Contrc 
2C 


»l Section: 
SMF70SCC 


2 


binary 


internal 


Size of CPU control section 


46 


2E 


SMF70CPU 


2 


binary 


CVTMAXMP + 1 


Number of CPU data sections in this record. (Data is not 
printed for CPUs that were offline at the end of the 
measurement interval, or had any VARY activity during 
the interval.) 


48 


30 


SMF70SCD 


2 


binary 


internal 


Size of each CPU data section 


50 


32 


SMF70RV2 


2 


binary 




Reserved 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


CPU Data Section: 










+0 




SMF70WAT 


8 


binary 


LCCAWTIM (Set by 
IRBMFDCP) 


CPU wait time, where bit 51 = 1 microsecond. That is, the 
amount of time that the CPU is not executing instructions 
(PSW wait state bit is on). 


+8 




SMF70CID 


2 


binary 


internal 

(CVTMAXMP for 
maximum) 


CPU identification (either or 1 ) 


+10 




SMF70RV3 


1 


binary 




Reserved 


+11 




SMF70CNF 


1 


binary 


CSDMF1CP 
CSDCPUAL 


Configuration activity indicator 

Bit Meaning When Set 
0-5 Reserved 

6 CPU varied online or offline during the measurement 
interval. Data for this CPU is invalid. 

7 CPU currently online 


+12 




SMF70RV4 


1 


binary 




Reserved 


+13 




SMF70SER 


3 


EBCDIC 


PCCACPID 


CPU serial number (6 hexadecimal digits) 



1 36 OS/VS2 System Management Facilities (SMF) 



Record Type 71 — Paging Activity 

Record type 71 is written by IRBMFDPP for each measurement interval and when 
MF/1 is terminated by a STOP operator command. It contains information about 
the demands made on the system paging facilities and the utilization of real and 
auxiliary storage during the reporting interval. Its length is 132 bytes. For more 
information about using this record, see OS/VS2 System Programming Library: 
Initialization and Tuning Guide. 

The format is: 



Offset* 


Name 


Length 


Format 


Source 


Description 








SMF71FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF71RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF71TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF71DTE 


4 


pecked 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


A 


SMF71SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


Com 

14 


monC 

E 


ontrol Data Sectio 
SMF71SIZ 


n: 
2 


binary 


internal 


Size of common control data section 


16 


10 


SMF71IST 


4 


packed 


CVTTZ and STCK 
operand of TIME 
macro (Set by 
IRBMFDPP) 


Time MF/1 measurement interval started, in the form 
0HHMMSSF where F is the sign 


20 


14 


SMF71DAT 


4 


packed 


CVTDATE (Set by 
IRBMFDPP) 


Date MF/1 measurement interval started, in the form 
00YYDDDF where F is the sign 


24 


18 


SMF71INT 


4 


packed 


STCK operand of 
TIME macro (Set by 
IRBMFDPP) 


Duration of MF/1 measurement interval, in the form 
MMSSTTTF where F is the sign. (The end of the 
measurement interval is the sgm of the recorded start time 
and this field.) 


28 


1C 


SMF71CYC 


2 


packed 




Reserved, in the form 000F 


30 


1E 


SMF71SUB 


6 


binary 




Reserved 


36 


24 


SMF71MFV 


2 


EBCDIC 


STSCMF1V 
(in STSCT) 


MF/1 version number 


38 


26 


SMF71RV1 


2 


binary 




Reserved 


40 


28 


SMF71RLS 


4 


EBCDIC 


CVTRELNO 


Operating system release number and level, in the form 
NNLL 


Pagir 
44 


gCoffl 
2C 


trol Section: 
! SMF71SPC 


2 


binary 


internal 


Size of paging control section 


46 


2E 


SMF71SPD 


2 


binary 


internal 


Size of paging data section 


Pagir 
48 


gDati 
30 


Section: 
SMF71PIN 


4 


binary 


PVTNPIN 1 


Number of non-VIO, non-swap page-ins. This field includes 
page-ins required through page faults, specific page 
requests, and page fixes. It does not include page reclaims, 
page-ins for VIO data sets, and pages that are swapped in. 1 


52 


34 


SMF71POT 


4 


binary 


PVTNPOUT 1 


Number of non-VIO, non-swap page-outs. This field 
includes page-outs required through specific page requests 
as well as those pages stolen by the paging supervisor as a 
result of infrequent use. It does not include page-outs for 
VIO data sets and pages that are swapped out. 1 



1 These fields refer to total system statistics. 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


Pagin 
56 


g Data 
38 


Section: (Conti 
SMF71PRC 


lued) 
4 


binary 


PVTNPREC 1 


Number of non-VIO page reclaims. This field contains the 
number of requests for pages as a result of page faults, 
specific page requests, and page fixes, that are satisfied 
without starting new page-ins. It does not include those 
pages that are recovered by explicit VIO reclaim. 1 


60 


3C 


SMF71SSQ 


4 


binary 


PVTNSWPS 1 


Number of address space swap sequences. (A swap sequence 
consists of an address space swap-out and swap-in.) 1 


64 


40 


SMF71SIN 


4 


binary 


PVTSPIN 1 


Number of pages swapped in. This field includes: LSQA, 
fixed pages, and those pages that the real storage manager 
determined to be active when the address space was swapped 
in. It does not include page reclaims. 1 


68 


44 


SMF71S0T 


4 


binary 


PVTSPOUT 1 


Number of pages swapped out. This field includes: LSQA, 
private area fixed pages, and private area non-fixed 
changed pages. 1 


72 


48 


SMF71VIN 


4 


binary 


PVTVAMI 1 


Number of VIO page-ins. This field includes page-ins 
resulting from page faults or specific page requests on a 
VIO window, it does not include VIO swap-ins or page-ins 
for the common area. 1 


76 


4C 


SMF71VOT 


4 


binary 


PVTVAMO 1 


Number of VIO page-outs. This field includes page-outs 
resulting from specific page requests on a VIO window, as 
well as those pages stolen by the paging supervisor as a 
result of infrequent use. It does not include VIO swap-outs 
or page-outs for the common area. 1 


80 


50 


SMF71VRC 


4 


binary 


PVTVAMR 1 


Number of VIO page reclaims. This field includes page 
reclaims required through a VIO request that was satisfied 
without page-in by means of the explicit VIO reclaim 
interface. 1 


84 


54 


SMF71SNI 


4 


binary 


PVTCAIN 


Number of non-VIO page-ins performed in common area 


88 


58 


SMF71SNO 


4 


binary 


PVTCAOUT 


Number of non-VIO page-outs performed in common area 


92 


5C 


SMF71SNR 


4 


binary 


PVTCAREC 


Number of non-VIO page reclaims performed in common 
area 


96 


60 


SMF71SVI 


4 


binary 


PVTCAVI 


Number of VIO page-ins performed in common area 


100 


64 


SMF71SVO 


4 


binary 


PVTCAVO 


Number of VIO page-outs performed in common area 


104 


68 


SMF71SVR 


4 


binary 


PVTCAVR 


Number of VIO page reclaims performed in common area 


108 


6C 


SMF71AFC 


4 


binary 


PVTAFC 


Number of page frames available in real storage 


112 


70 


SMF71TFC 


4 


binary 


PVTPOOL 


Number of page frames defined in real storage. (This field 
does not include frames occupied by the nucleus and 
frames marked as bad or offline.) 


116 


74 


SMF71TSC 


4 


binary 


ASMSLOTS 


Number of auxiliary storage page slots in the user pool of 
paging data sets 


120 


78 


SMF71DSC 


4 


binary 


ASMVSC 


Number of auxiliary storage page slots allocated to VIO 
data sets in the user pool 


124 


7C 


SMF71VSC 


4 


binary 


ASMNVSC 


Number of auxiliary storage page slots allocated to non- 
VIO address spaces in the user pool 


128 


80 


SMF71NSC 


4 


binary 


ASMSLOTS - 
{ASMVSC + 
ASMNVSC + 
ASMERRS) 


Number of auxiliary storage page slots that have not been 
allocated 



1 These fields refer to total system statistics. 
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Record Type 72 — Workload Activity 

Record type 72 is written by IRBMFDWP for each performance group (PG) defined 
in the installation performance specification (IPS). Type 72 records are generated in 
the order of low to high PG number. Each record contains data on the one-to-eight 
PG periods for a PG number. Its length is 60 bytes plus 20 bytes for each PG period 
data section. 

This record contains the PG number, number of PG periods, IPS name, number 
of terminated transactions, elapsed time of terminated transactions, and active time, 
service and workload level of all transactions. For more information about using 
this record, see OS/VS2 System Programming Library: Initialization and Tuning 
Guide. 

The format is: 



Offsets 


Name 


Length 


Format 


Source 


Description 








SMF72FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF72RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF72TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF72DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF72SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


Com 
14 


monC 

E 


antral Data Sectio 
SMF72SIZ 


n: 
2 


binary 


internal 


Size of common control data section 


16 


10 


SMF72IST 


4 


packed 


CVTTZ and STCK 
operand of TIME 
macro (Set by 
IRBMFDWP) 


Time MF/1 measurement interval started, in the form 
0HHMMSSF where F is the sign 


20 


14 


SMF72DAT 


4 


packed 


CVTDATE (Set by 
IRBMFDWP) 


Date MF/1 measurement interval started, in the form 
OOYYDDDF where F is the sign 


24 


18 


SMF72INT 


4 


packed 


STCK operand of 
TIME macro (Set by 
IRBMFDWP) or 
WAMTTOC and 
WAMTTMA (Set 
by IRARMWAR) 


Duration of MF/1 measurement interval, in the form 
MMSSTTTF where F is the sign. (The end of the 
measurement interval is the sum of the recorded start time 
and this field.) 


28 


1C 


SMF72CYC 


2 


packed 




Reserved, in the form 000F 


30 


1E 


SMF72SUB 


2 


binary 


internal 


Performance group (PG) number. The range of values is 
1 to 255. 


32 


20 


SMF72SAM 


4 


binary 




Reserved 


36 


24 


SMF72MFV 


2 


EBCDIC 


STSCMF1V 
(in STSCT) 


MF/1 version number 


38 


26 


SMF72RV1 


2 


binary 




Reserved 


40 


28 


SMF72RLS 


4 


EBCDIC 


CVTRELNO 


Operating system release number and level, in the form 
NNLL 
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Offsets 


Name 


Length 


Format 


Source 


Description 


Workload Control Section: 










44 


2C 


SMF72SWC 


2 


binary 


internal 


Size of workload control section 


46 


2E 


SMF72PGP 


2 


binary 


internal 
(inWAMT) 


Number of PG period data sections in this record 


48 


30 


SMF72SPD 


2 


binary 


internal 


Size of each PG period data section 


50 


32 


SMF72HPG 


2 


binary 


WAMTHPG 


Highest PG number defined in installation performance 
specification (IPS) 


52 


34 


SMF72IPS 


8 


EBCDIC 


WAMTIPS 


Name of IPS 


Perfo 


rmanci 


3 Group Period D< 


ita Sectic 


n: 






+0 




SMF72TTX 


4 


binary 


WAMPTRN 


Number of transactions terminated 


+4 




SMF72ACT 


4 


binary 


WAMPTAT (Set by 
IRARMWAR) 


Active time of all transactions, in 1024-micr.osecond units. 
This field includes the total time that each transaction was 
in real storage plus any swapped-out time that the 
transactions were not in a "wait" state. It does not include 
time between job steps for batch transactions. 


+8 




SMF72SER 


4 


binary 


WAMPSRV 


Service used in all transactions, in service units 


+12 




SMF72TTM 


4 


binary 


WAMPTET (Set by 
IRARMWAR) 


Elapsed time accumulated by all transactions that 
terminated in this PG period, in 1024-microsecond units 


+16 




SMF72LEV 


4 


binary 


WAMPNWL 


Workload level of all transactions, in units of 1/256 of 
a level 



1 40 OS/VS2 System Management Facilities (SMF) 



Record Type 73 -^ Channel Activity 

Record type 73 is written by IRBMFDHP for all channels in the system that have 
been online at least once since MF/1 was started. It is not produced for channels 
that were offline at the end of the reporting interval, or for channels that were 
varied during the interval. Its length is 52 bytes plus 16 bytes for each channel data 
section. 

This record contains the sampling cycle length, number of samples, number of 
channels, CPU identification, channel identification, number of successful START 
I/Os issued to the channel, number of samples in which the channel was in burst 
mode, and number of samples in which the channel was busy and the CPU was in the 
wait state. For more information about using this record, see OS/VS2 System 
Programming Library: Initialization and Tuning Guide. 

The format is: 



* Offsets 


Name 


i Length 


Format | Source 


Description 








SMF73FLG 


1 


binary 


SVC 83 


System hndicator 

Bit Meaning When Set 
0?5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF73RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF73TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF73DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
00YYDDDF where F is the sign 


10 


-A 


SMF73SID 


4 


EBCDIC 


SMCASID 


System identification (taken from SID parameter) 


Com 

14 


monC 

E 


antral Data Sectio 
SMF73SIZ 


n: 
2 


binary 


internal 


Size of common control data section 


16 


10 


SMF73IST 


4 


packed 


CVTTZ and STCK 
operand of TIME 
macro (Set by 
IRBMFDHP) 


Time MF/1 measurement interval started, in the form 
OHHMMSSF where F is the sign 


20 


14 


SMF73DAT 


4 


packed 


CVTDATE (Set by 
IRBMFDHP) 


Date MF/1 measurement interval started, in the form 
OOYYDDDF Where F is the sign 


24 


18 


SMF73INT 


4 


packed 


STCK operand of 
TIME macro (Set by 
IRBMFDHP) 


Duration of MF/1 measurement interval, in the form 
MMSSTTTF where F is the sign. (The end of the 
measurement interval is the sum of the recorded start time 
and this field.) 


28 


1C 


SMF73CYC 


2 


packed 


internal 


Sampling cycle length, in the form TTTF where F is the 
sign (taken from CYCLE keyword). The range of values 
is 0.050 to 0.999 seconds. 


30 


1E 


SMF73SUB 


2 


binary 




Reserved 


32 


20 


SMF73SAM 


4 


binary 


internal (Set by 
IRBMFECH) 


Number of samples 


36 


24 


SMF73MFV 


2 


EBCDIC 


STSCMF1V 
(in STSCT) 


MF/1 version number 


38 


26 


SMF73RV1 


2 


binary 




Reserved 


40 


28 


SMF73RLS 


4 


EBCDIC 


CVTRELNO 


Operating system release number and level, in the form 
NNLL 
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SMF Records 141 



Offsets 


Name 


Length 


Format 


Source 


Description 


Common Control Data Section: (Continued) 






44 


2C 


SMF73SHC 


2 


binary 


internal 


Size of channel control section 


46 


2E 


SMF73CHA 


2 


binary 


internal 


Number of channel data sections in this record 


48 


30 


SMF73SHD 


2 


binary 


internal 


Size of each channel data section 


50 


32 


SMF73RV2 


2 


binary 




Reserved 


Channel Da 


ta Section: 










+0 




SMF73CID 


2 


binary 


internal 

(CVTMAXMP for 
maximum) 


CPU identification (either or 1) 


+2 




SMF73HID 


1 


binary 


internal 

(CSDCHAD for 
maximum) 


Channel identification. The range of values is to 15. 


+3 




SMF73FG2 


1 


binary 


CATCH ID 
CATCH ID 

CATNID 
CATNOP 

CATNOP 


Channel indicator (If zero, selector channel) 

Bit Meaning When Set 
0-1 Reserved 

2 Block multiplexor 

3 Byte multiplexor 

4 Reserved 

5 Invalid channel identification 

6 Data recorded is invalid because channel was varied 
during interval 

7 Channel is currently online 


+4 




SMF73CNT 


4 


binary 


CATSIOCT 


Number of successful START l/Os issued to the channel. 
This field includes redundant, successful START I/O Fast 
Release instructions (condition code zero). It does not 
include "sense" START l/Os. 


+8 




SMF73BSY 


4 


binary 


TCH instruction 
(Set by IRBMFTCH 
orlRBMFECH) 


Number of samples in which the channel was in burst mode. 
(This field is zero for byte multiplexor channels.) 


+12 




SMF73QLP 


4 


binary 


Set by IRBMFTCH 
or IRBMFECH when 
TCH has condition 
code 2 and 
PSATOLD= 
CVTWTCB 


Number of samples in which the channel was busy and the 
CPU was in the wait state. (This field is zero for byte 
multiplexor channels.) 

■■-■■ - 
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Record Type 74 — Device Activity 

Record type 74 is written by IRBMFDDP for all devices in the device classes 
selected by device-class keywords. It is only written for devices that have been 
online at least once since MF/1 was started. Record type 74 is not written for 
devices that were offline at the end of the reporting interval, or for devices that 
were varied during the interval. Its length is 52 bytes plus 28 bytes for each device 
data section. 

This record contains the sampling cycle length, number of samples, number of 
devices, volume serial number, number of requests serviced on the device, number 
of samples in which the device was busy, number of requests enqueued for the 
device, and device address, class and type. For more information about using this 
record, see OS/VS2 System Programming Library : Initialization and TuningGuide. 

The format is: 



Offsets 


Name 


Length 


Format I Source 


Description 








SMF74FLG 


1 


binary 


SVC 83 


System indicator 

Bit Meaning When Set 
0-5 Reserved 

6 VS2 

7 Reserved 


1 


1 


SMF74RTY 


1 


binary 


internal 


Record type 


2 


2 


SMF74TME 


4 


binary 


SVC 83 


Time, in hundredths of a second, record was moved to 
SMF buffer 


6 


6 


SMF74DTE 


4 


packed 


SVC 83 


Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


10 


A 


SMF74SID 


4 


EBCDIC 


SMC AS ID 


System identification (taken from SID parameter) 


Com 

14 


mon O 

E 


Dntrol Data Sectio 
SMF74SIZ 


n: 
2 


binary 


internal 


Size of common control data section 


16 


10 


SMF74IST 


4 


packed 


CVTTZ and STCK 
operand of TIME 
macro (Set by 
IRBMFDDP) 


Time MF/1 measurement interval started, in the form 
OHHMMSSF where F is the sign 


20 


14 


SMF74DAT 


4 


packed 


CVTDATE (Set by 
IRBMFDDP) 


Date MF/1 measurement interval started, in the form 
OOYYDDDF where F is the sign 


24 


18 


SMF74INT 


4 


packed 


STCK operand of 
TIME macro (Set 
by IRBMFDDP) 


Duration of MF/1 measurement interval, in the form 
MMSSTTTF where F is the sign. (The end of the 
measurement interval is the sum of the recorded start time 
and this field.) 


28 


1C 


SMF74CYC 


2 


packed 


internal 


Sampling cycle length in the form TTTF where F is the 
sign (taken from CYCLE keyword). The range of values 
is 0.050 to 0.999 seconds. 


30 


IE 


SMF74SUB 


2 


binary 


UCBTBYT3 


Device class (in right byte) 


32 


20 


SMF74SAM 


4 


binary 


internal (Set by 
IRBMFEDV) 


Number of samples 


36 


24 


SMF74MFV 


2 


EBCDIC 


STSCMF1V 
(in STSCT) 


MF/1 version number 


38 


26 


SMF74RV1 


2 


binary 




Reserved 


40 


28 


SMF74RLS 


4 


EBCDIC 


CVTRELNO 


Operating system release number and level, in the form 
NNLL 



(Continued) 
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Offsets 


Name 


Length 


Format 


Source 


Description 


Device Control Section: 










44 


2C 


SMF74SDC 


2 


binary 


internal 


Size of device control section 


46 


2E 


SMF74DEV 


2 


binary 


internal 


Number of device data sections in this record 


48 


30 


SMF74SDD 


2 


binary 


internal 


Size of each device data section 


50 


32 


SMF74RV2 


2 


binary 




Reserved 


Device Deta 


Section: 










+0 




SMF74ADD 


2 


packed 


UCBNAME 


Device address, in the form HHHF where F is the sign 


+2 




SMF74RV3 


1 


binary 




Reserved 


+3 




SMF74CNF 


1 


binary 


UCBONLI or 
UCBNAME (Set by 
IRBMFEDV) 

UCBONLI (Set by 
IRBMFEDV) 


Device indicator 

Bit Meaning When Set 
0-5 Reserved 

6 Data recorded is invalid because device was varied 
during interval 

7 Device is currently online 


+4 




SMF74TYP 


4 


binary 


UCBTYP 


Unit type 


+8 




SMF74SER 


6 


EBCDIC 


UCBVOLI 


Volume serial number of the volume mounted on this device 


+14 




SMF74RV4 


2 


binary 




Reserved 


+16 




SMF74CNT 


4 


binary 


UCBMFCNT (Set 
by IRBMFEDV) 


Number of requests serviced on this device 


+20 




SMF74ACT 


4 


binary 


UCBBSY (Set by 
IRBMFEDV) 


Number of samples in which this device was busy 


+24 




SMF74QUE 


4 


binary 


UCBCNT (Set by 
IRBMFEDV) 


Number of requests enqueued for this device observed at 
samples 
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Appendix A: Field-to-Record Cross-Reference 



This appendix lists all of the fields in the SM F records in alphabetical order and 
identifies the record type containing each field. It also gives the displacement of 
the field within the record. 

Some records have sections of fields that are generated only when specific events 
occur, such as when IPL is completed or when a device is varied online or offline. 
The following abbreviations will appear under the "offset" column to indicate the 
section of the record where the field is found: 

ACT Accounting section 

CHAN Channel section 

CHND Channel data section 

CPU CPU section 

CPUD CPU data section 

DCB DCB/DEB DASD extension entry 

DEV Device entry 

DEVD Device data section 

DSC Data set characteristics section 

EXT Extent entry 

ISAM ISAM extension section 

MSS MSS IPL configuration section 

PERF Performance group period data section 

PRNT 3800 Printing Subsystem section (VS2.03.810) 

REL Relocate section 

STAT Statistics section 

STOR Storage section 

TAPD DCB/DEB tape extension entry 

TAPU UCB tape extension entry 

UCB UCB section 

VAR VARY ONLINE,S and VARY OFFLINE,S section 

VOL Volume entry 
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Field Description 


Record 
Type 


Offs 
Dec. 


et 
Hex. 


Access-method interfaces option codes 


14 
15 


246 
246 


F6 
F6 


Accounting fields, job 


5 

20 

35 


117 

61 

117 


75 
3D 
75 


Accounting fields, step 


4 
34 


ACT 
ACT 




Accounting number, programmer's 


26* 


100 


64 


Address, CPU 


22 
22 


CPU 
CHAN 




Address, line adapter 


48* 
48** 


68 
76 


44 

4C (VS2.03.812) 


Address. VTOC 


19 


36 


24 


Address of lowest page in real 
contiguous storage 


22 


STOR 




Address space dispatching priority 


4 
34 


53 
53 


35 
35 


Address space swap sequences 


4 

34 

71 


REL 
REL 
60 


3C 


Allocation, device start time 


4 
34 


86 
86 


56 
56 


Allocation status indicator 


14 
15 
25** 


63 
63 
38 


3F 
3F 
26 (VS2.03.812) 


Alternate tracks, number of unused 


19 


46 


2E 


Auxiliary storage page slots allocated 


71 


124 


7C 



to non-VIO address spaces in the user 
pool 

Auxiliary storage page slots allocated 71 120 78 

to VIO data sets in the user pool 

Auxiliary storage page slots in the 71 116 74 

user pool of paging data sets 

Auxiliary storage page slots that have 71 128 80 

not been allocated 



Beginning cylinder and track 



64 



EXT 



•These records are for JES2 only. 
••These records are for JES3 only. 

1 Except 2, 3, 4, 5, 34 and 35. 



Block count volume 




14 
15 


TAPD 
TAPD 




Block size 




21 
64 


40 
DSC 


28 


BUF parameter 







18 


12 


Buffer, date record was i 


moved to 


ALL 1 


6 


6 


Buffer, number of bytes 


in 





18 


12 
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Field Description 



•These records are for JES2 only. 
"These records are for JES3 only. 

1 Except 2, 3, 4, 5, 34 and 35. 



Buffer, size of time-sharing 

Buffer, time record was moved to 

Buffers, number allowed per terminal . 
before LWAIT 

Buffers, number allowed per terminal 
before OWAIT 

Buffers, number reserved on free queue 

Buffers, number of time-sharing 

Burst mode, number of samples in 
which channel was in 

| Burster-Trimmer-Stacker 

Bus-out checks, number of 

Busy, number of samples in which 
channel/device was 

Cards, input, number of 

Cards, punched, number of 

Cards generated to spool, number of 



Card-image records in DD DATA and 
DO* data sets read for step/job 

Catalog name 



Record 


Offset 


Type 


Dec. Hex. 


31 


16 10 


ALL 1 


2 2 


31 


22 16 



Catalog record size 

Catalog records 

CCHH, beginning 
CCHH, ending 
Channel address 



31 



64 



64 



20 



14 



31 


28 


1C 


31 


14 


E 


73 


CHND 




6 


PR NT 


(VS2.03.810) 


48** 


62 


3E (VS2.03.812) 


73 
74 


CHND 
DEVD 




26* 
26** 


204 
244 


CC 
F4(VS2.03.812) 


26 


116 


74 


26* 
26** 


212 
248 


04 

F8 (VS2.03.812) 


4 
5 


47 
47 


2F 
2F 


62 
63 
64 
67 
68 
69 


42 
44 
40 
40 
38 
52 


2A 
2C 
28 
28 
26 
34 


63 
63 
67 


40 
42 
128 


28 
2A 
80 


63 
67 


132 
130 


84 
82 



EXT 



EXT 



4 


DEV 




8 


DEV 




9 


DEV 




10 


DEV 




11 


DEV 




14 


UCB 




15 


UCB 




19 


60 


3C 


21 


22 


16 


22 


CHAN 




34 


DEV 




40 


DEV 




64 


EXT 




69 


38 


26 
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•These records are for JES2 only. 
••These records are for JES3 only. 



Field Description 


Record 
Type 


Offset 
Dec. Hex. 


Channel indicator 


73 


CHND 




Channel model number 


22 
73 


CHAN 
CHND 




Character arrangement table names 


6 


PRNT 


(VS2.03.810) 


Class, job 


5 
26 


71 
85 


47 
55 


Class, message 


26 


84 


54 


Class, SYSOUT 


6 


38 


26 


Cleaner actions, number of 


21 


37 


25 


Command rejects, number of 


48«. 


60 


3C(VS2.03.812) 


Common area page-ins 


4 
34 


REL 
REL 


(VS2.03.807) 
(VS2.03.807) 


Common area reclaims 


4 
34 


REL 
REL 


(VS2.03.807) 
(VS2.03.807) 


Completion code, JES2 


45* 


22 


16 


Completion code, JES3 


45* • 


21 


15(VS2.03.812) 


Completion code, job 


5 
35 


51 
51 


33 
33 


Completion code, step 


4 
34 


51 
51 


33 
33 


Component indicator 


64 


39 


27 


Component or cluster name 


62 
64 


92 
84 


5C 
54 


Configuration activity indicator 


70 


CPUD 




Continuous wait time limit 





14 


E 


Control areas, number that were split 


64 


STAT 




Control interval size 


64 


DSC 




Control intervals, number of unused 


64 


STAT 




Control intervals, number that were 
split 


64 


STAT 




Conversion processor (CPU) 
identification 


26* 
26* • 


220 
260 


DC 
104(VS2.03.812) 


Converter start time and date 


26 # 
26 ## 


152 
192 


98 

CO (VS2.03.812) 


Converter stop time and date 


26* 
26* * 


160 
200 


A0 

C8 (VS2.03.812) 


Copies, number printed with overlay 


6 


PRNT 


(VS2.03.810) 


Copy groups 


6 


PRNT 


(VS2.03.810) 
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Record 


Offset 


Field Description 




Type 


Dee. 


Hex. 


Copy modification module i 


name 


6 


PRNT 


(VS2.03.810) 


CPU address 




22 


CPU 




CPU identification 




70 
73 


CPUD 
CHND 




CPU model number 




22 
70 


CPU 
CPUD 




CPU time 




4 
4 


95 
ACT 


5F 






5 


73 


49 






5 


113 


71 






34 


95 


5F 






34 


ACT 








35 


73 


49 






35 


113 


71 


CPU wait time 




70 


CPUD 




Cycle length, sampling 




73 


28 


1C 






74 


28 


1C 


Cylinder overflow areas that 


are full. 


14 


ISAM 




number of 




15 


ISAM 




Cylinders, number of unallocated 


19 


48 


30 






69 


44 


2C 


Cylinders in independent index. 


14 


ISAM 




prime data, and independen 


t overflow 


15 


ISAM 





areas, number of 

Cylinders in largest continuous 
unallocated area, number of 

Cylinders in largest unallocated 
extent, number of 

DASD volume status indicator 



Data checks to read text, number of 

Data format error indicators 
Data overruns, number of 
Data recording devices (DRDs) 
Data set control indicator 
Data set indicator 



69 



19 



48 



52 



30 



34 



Data set name 



Data set organization 



•These records are for JES2 only. 
* "These records are for JES3 only. 



14 


UCB 




15 


UCB 




48* 


56 


38 


48** 


64 


40 (VS2.03.812) 


5*« 


88 


58 (VS2.03.812) 


48** 


65 


41 (VS2.03.812) 


22 


MSS 




6 


62 


3E 


14 


38 


26 


14 


51 


33 


14 


248 


F8 


15 


38 


26 


15 


51 


33 


15 


248 


F8 


17 


40 


28 


18 


40 


28 


18 


84 


54 


14 


240 


F0 


15 


240 


F0 
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*These records are for JES2 only. 
**These records are for JES3 only. 



Field Description 



Data set sequence count 

Data set sequence number 

Data set serial number 

Data sets processed by writer, 
number of 

Data space extents, number of free 

Date, deadline schedule 

Date, JES3 allocation 

Date, JES3 device verification 

Date, logoff 

Date, logon 

Date, logon enqueue 

Date *START SETUP command issued 

Date converter started 

Date converter stopped 

Date execution processor started 

Date execution processor stopped 

Date fetch processing started 

Date first volume mount 
message issued 

Date initiator selected step/job 
Date job terminated 
Date MF/1 interval started 



Date output processor started 



Date output processor stopped 



Record 


Offset 


Type 


Dec. Hex. 


14 


TAPU 


15 


TAPU 


14 


TAPU 


15 


TAPU 


14 


TAPD 


15 


TAPD 



52 



34 



69 


42 


2A 




26** 


168 


A8 (VS2.03.812) 


25** 


76 


52 (VS2.03.812) 


25** 


84 


5A (VS2.03.812) 


35 


6 


6 




34 
35 
40 


26 
26 
26 


1A 
1A 
1A 




35 


58 


3A 




25 


60 


3C 


(VS2.03.812) 


26* 
26** 


156 
196 


9C 
C4 


(VS2.03.812) 


26* 
26** 


164 
204 


A4 

CC (VS2.03.812) 


26* 
26** 


172 
212 


AC 
D4 


(VS2.03.812) 


26* 
26** 


180 
220 


B4 
DC 


(VS2.03.812) 


25** 


52 


34 


(VS2.03.812) 


25** 


76 


52 


(VS2.03.812) 


4 
5 


43 
43 


2B 
2B 




5 
35 


6 
6 


6 
6 




70 
71 
72 
73 
74 


20 
20 
20 
20 
20 


14 
14 
14 
14 
14 




26* 
26** 


188 
228 


BC 
E4 


(VS2.03.812) 


26* 
26** 


196 
236 


C4 
EC 


(VS2.03.812) 
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Record 


Offset 


Field Description 


Type 


Dec. 


Hex. 


Date output service started 


6 ## 


43 


28 (VS2.03.812) 


Date print/punch processor started 


6* 


43 


2B 


Date reader recognized end of job 


5 


58 


3A 




26* 


148 


94 




26** 


188 


BC (VS2.03.812) 


Date reader recognized the JOB card 


4 


26 


1A 




5 


26 


1A 




6 


26 


1A 




10 


26 


1A 




14 


26 


1A 




15 


26 


1A 




17 


26 


1A 




18 


26 


1A 




20 


26 


1A 




25** 


26 


1A (VS2.03.812) 




26 


26 


1A 




40 


26 


1A 




62 


26 


1A 




63 


26 


1A 




64 


26 


1A 




67 


26 


1A 




68 


26 


1A 




69 


26 


1A 


Date record was moved to dump 


2 


6 


6 


data set 


3 


6 


6 



•These records are for JES2 only. 
••These records are for JES3 only. 

1 Except 2, 3, 4, 5, 34 and 35. 



Date record was moved to SMF buffer ALL 

Date recording was started when 7 

SMF data set became available 

Date step terminated 



DCB=OPTCD=J 

DD DATA and DD* data set records 
read for step/job 

DD entry length 



DD name 

Deadline schedule date 

Deadline schedule time 

Deadline schedule type 

Deleted records, number of 

Density, tape 

Dependent job net identification 

Device address 

Device allocation requests, number of 



20 



14 



4 


6 


6 


34 


6 


6 


6 


PRNT 


(VS2.03.810) 


4 


47 


2F 


5 


47 


2F 


14 


48 


30 


15 


48 


30 


14 


52 


34 


15 


52 


34 


26 


132 


84 


64 


DSC 




26** 


168 


A8 (VS2.03.812) 


26** 


164 


A4 (VS2.03.812) 


26** 


120 


78 (VS2.03.812) 


64 


STAT 




21 


39 


27 


26** 


156 


9C (VS2.03.812) 


74 


DEVD 




14 


50 


32 


15 


50 


32 
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Field Description 


Record 
Type 


Offset 
Dec. Hex. 


Device class 


4 

5 

8 

9 

10 

11 

34 

40 

74 


DEV 

69 

DEV 

DEV 

DEV 

DEV 

DEV 

DEV 

30 


45 
1E 


Device indicator 


14 
14 
15 
15 
74 


51 

248 

51 

248 

DEVD 


33 
F8 
33 
F8 


Device name, logical input 


26 


92 


5C 


Device name, logical output 


6 


68 


44 


Device recording controls, MSF 


22 


MSS 




Device SSI D 


22 


VAR 




Devices, MSF data recording 


22 


MSS 




Devices requested during allocation, 
number of 


14 
15 


50 
50 


32 
32 


Device allocation start time 


4 
34 


86 
86 


56 
56 


Disk volumes fetched, number of 


25»* 


44 


2C (VS2.03.812) 


Disk volumes mounted, number of 


25 # * 


68 


44 (VS2.03.812) 


Drive number 


19 


62 


3E 


DSCBs, number of 


19 


42 


2A 


DSCBOs, number of 


19 


44 


2C 


Dump data set, date record was 
moved to 


2 
3 


6 
6 


6 
6 


Dump data set, time record was 
moved to 


2 
3 


2 
2 


2 
2 


End-of-volume indicator 


14 
*5 


249 
249 


F9 
F9 


Ending cylinder and track 


64 


EXT 




Entry name 


63 
67 
68 
68 


88 
84 
82 
126 


58 
54 
52 
7E 


Entry type indicator 


63 
63 
67 
67 


38 
39 
38 
39 


26 
27 
26 
27 


Equipment checks, number of 


48»* 


63 


3F (VS2.03.812) 



••These records are for JES3 only. 
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•These records are for JES2 only. 
h *These records are for JES3 only. 



Field Description 


Record 
Type 


Offset 
Dec. Hex. 


Erase gaps, number of 


21 


35 


23 


Errors, line 


48* 
48#. 


64 
52 


40 

34 (VS2.03.812) 


EXCP count 


4 

14 

15 

34 

40 

48 

64 


DEV 

UCB 

UCB 

DEV 

DEV 

48 

STAT 


30 


Execution processor (CPU) 
identification 


26* 
26** 


224 
264 


E0 

108 (VS2.03.812) 


Execution processor start time and 
date 


26* 
26** 


168 
208 


A8 

DO (VS2.03.812) 


Execution processor stop time and 
date 


26* 
26** 


176 
216 


B0 

D8 (VS2.03.812) 


Execution time, estimated 


26 


108 


6C 


Extents, number of 


14 
15 
64 


UCB 
UCB 
STAT 




Extents, number of unallocated 


19 


56 


38 


Extents in independent index, prime 
data, and independent overflow 
areas, number of 


14 
15 


ISAM 
ISAM 




Extents released by DADSM routine, 
number of 


14 
15 


DCB 
DCB 




FCB image identification 


6 


76 


4C 


Fetch processing start date 


25** 


52 


34 (VS2.03.812) 


Fetch processing start time 


25** 


48 


30 (VS2.03.812) 


Form number 


6 
26* 


53 
120 


35 
78 


Forms Overlay name 


6 


PRNT 


(VS2.03.810) 


Functional indicator 


40 


39 


27 


Highest used relative byte address 


64 


130 


82 


I/O processing method indicator 


14 
15 


249 
249 


F9 
F9 


I/O status 


6 


51 


33 


Index levels, number of 


14 
15 
64 


ISAM 
ISAM 
STAT 




Initialization deck origin 


43** 


25 


19 (VS2.03.812) 


Initiator select date for step/job 


4 
5 


43 
43 


2B 
2B 


Initiator select time for step/job 


4 
5 
34 


39 
39 
39 


27 
27 
27 
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•These records are for JES2 only. 
**These records are for JES3 only. 



Field Description 



Record 
Type 



Offset 
Dec. Hex. 



Input cards for job, number of- 

Input class for job 

Input processor (CPU) identification 

Input route code 

Input/output (see I/O) 

Inserted records, number of 

Interventions required, number of 

IPS name 

JES2 completion code 

JES2 identification 



JES2 job selection priority 

JES2 logical input device name 
JES2 logical output device name 
JES2 output selection priority 

JES2 start options 

JES2 termination indicator 

JES2-assigned job number 

J ES3 allocation date 
JES3 allocation time 
JES3 completion code 
JES3 device verification date 
JES3 device verification time 
JES3 identification 



26* 

26* • 



26* 
26** 

26* 



204 CC 

244 F4 (VS2.03.812) 

71 47 

216 D8 

256 100 (VS2.03.812) 

90 5A 



64 


STAT 




48** 


61 


3D (VS2.03.81 2) 


72 


52 


34 


45 


22 


16 


6* 

26* 

43* 

45* 

47* 

48* 

49* 


58 
42 
14 
14 
14 
t4 
14 


3A 
2A 

E 
E 
E 
E 
E 


26* 
26* 


86 
87' 


56 
57 


26* 


92 


5C 


6* 


68 


44 


26* 
26* 


88 
89 


58 
59 


43* 


23 


17 


45* 


20 


14 


6* 
26* 


64 
52 


40 
34 


25** 


76 


52 (VS2.03.812) 


25** 


72 


48 (VS2.03.812) 


45** 


21 


15 (VS2.03.812) 


25** 


84 


54 (VS2.03.812) 


25** 


80 


56 (VS2.03.812) 


6* 

26** 

43** 

45** 

47** 

48** 

49** 


56 
42 
14 
14 
14 
14 
14 


3A (VS2.03.812) 
2 A (VS2.03.812) 
E (VS2.03.812) 
E (VS2.03.812) 
E (VS2.03.812) 
E (VS2.03.812) 
E (VS2.03.812) 



JES3 initialization deck origin 
location 



43* 



26 



1A (VS2.03.812) 



1S4 OS/VS2 System Management Facilities (SMF) (VS2.03.8 10) 



VS2.03.807 
VS2.03.810 
VS2.03.812 



Field Description 



JES3 initialization deck origin type 
JES3 job selection priority 

JES3 logical input device group name 

JES3 logical input device name 

JES3 logical output device group name 

JES3 logical output device name 

JES3 procedure name 

JES3 start options 

JES3 termination indicator 

JES3-assigned job number 

JFCB 

JFCB TTR address 

Job accounting fields 

lob class 

lob class name 

Job completion code 

Job CPU time 



Job identification 

Job information indicator 

Job log identification 



Record 
Type 


Offset 
Dec. Hex. 


43* # 


25 


19 (VS2.03.812) 


26** 
26* * 


86 
87 


56 (VS2.03.812) 

57 (VS2.03.812) 


26* • 


124 


7C (VS2.03.812) 


26* * 


92 


5C (VS2.03.812) 


26** 


92 


5C(VS2.03.812) 


26** 


68 


44 (VS2.03.812) 


43** 


34 


22 (VS2.03.812) 


43** 


22 


16 (VS2.03.812) 


45** 


20 


14 (VS2.03.812) 


6** 
26** 


64 
52 


40 (VS2.03.812) 
34 (VS2.03.812) 


14 
15 


64 
64 


40 
40 


14 
15 


60 
60 


3C 
X 


5 

20 

35 


117 

61 

117 


75 
3D 
75 


5 
26 


7V 
85 


47 
55 



26* 



172 



AC (VS2.03.812) 



5 


51 


33 


35 


51 


33 


5 


73 


49 


5 


113 


71 


35 


73 


49 


35 


113 


71 


26 


56 


38 


26 


50 


32 


4 


14 


E 


5 


14 


E 


6 


14 


E 


10 


14 


E 


14 


14 


E 


15 


14 


E 


17 


14 


E 


18 


14 


E 


20 


14 


E 


25** 


14 


E (VS2.03.812) 


26 


14 


E 


40 


14 


E 


62 


14 


E - 


63 


14 


E 


64 


14 


E 


67 


14 


E 


68 


14 


E 


69 


14 


E 



"These records are for JES3 only. 



Appendix A: Field-to-Recoid Cross-Reference 155 



VS2.03.807 
VS2.03.810 
VS2.03.812 



•These records are for JES2 only. 
* "These records are for JES3 only. 



Field Description 



Job name 



Job number 

Job print copy count 
Job print route code 
Job priority 

Job selection priority 

Job punch route code 
Job service 

Job termination date 

Job termination indicator 

Job termination time 

Job transaction active time 

Job transaction residency time 

Job wait time limit 
JWT parameter 
Key, storage protect 

Key length 



Record 


Offset 


Type 


Dec. 


Hex. 


4 


14 


E 


5 


14 


E 


6 


14 


E 


10 


14 


E 


14 


14 


E 


15 


14 


E 


17 


14 


E 


18 


14 


E 


20 


14 


E 


25** 


14 


E (VS2.03.812) 


26 


14 


E 


34 


14 


E 


35 


14 


E 


40 


14 


E 


62 


14 


E 


63 


14 


E 


64 


14 


E 


67 


14 


E 


68 


14 


E 


69 


14 


E 


6 


64 


40 


26 


52 


34 


26* 


124 


7C 


26* 


128 


80 


5 


53 


35 


35 


53 


35 


26 


86 


56 


26 


87 


57 


26* 


130 


82 


5 


76 


4C 


35 


76 


4C 


5 


6 


6 


35 


6 


6 


5 


62 


3E 


35 


62 


3E 


5 


2 


2 


35 


2 


2 


5 


80 


50 


35 


80 


50 


5 


64 


40 (VS2.03.807) 


35 


64 


40 (VS2.03.807) 





14 


E 





14 


E 


4 


82 


52 


5 


72 


48 


34 


82 


52 


35 


72 


48 



64 



DSC 



156 OS/VS2 System Management Facilities (SMF) (VS2.03.810) 



VSZ.UJ.8U/ 

VS2.03.810 
VS2.03.812 



'These records are for JES2 only. 
••These records are for JES3 only. 



Field Description 


Record 
Type 


Offset 
Dec. Hex. 


Length of OD entry 


14 
15 


48 
48 


30 
30 


Limit, continuous wait time 





14 


E 


Line adapter address 


48 # 
48 ,# 


68 
76 


44 

4C (VS2.03.812) 


Line errors 


48* 
48 ,# 


64 
52 


40 

34 (VS2.03.812) 


Line name 


47 
.48 
49 


32 
32 
32 


20 
20 
20 


Lines, output, number of 


26 


112 


70 


Lines, terminal input, number of 


34 
35 


47 
47 


2F 
2F 


Lines, terminal output, number of 


34 
35 


43 
43 


2B 
2B 


Lines generated to spool, number of 


26* 
26* • 


208 
248 


DO 

F8 (VS2.03.812) 


Lines per page, number of 


26* 


126 


7E 


Logical record size, maximum 


64 


DSC 




Logical records, number written 


6 


47 


2F 


Logical records in overflow and prime 
data areas, number of 


14 
15 


ISAM 
ISAM 




Logoff date 


35 


6 


6 


Logoff time 


35 


2 


2 


Logon date 


34 
35 
40 


26 
26 
26 


1A 
1A 
1A 


Logon enqueue date 


35 


58 


3A 


Logon enqueue time 


35 


54 


36 


Logon priority 


35 


53 


35 


Logon time 


34 
35 
40 


22 
22 
22 


16 
16 
16 


Lost datas, number of 


48** 


66 


42 (VS2.03.812) 


Lowest page address in real 
contiguous storage 


22 


STOR 




Macro instruction and option types 


14 
14 
15 
15 


243 
ISAM 
243 
ISAM 


F3 
F3 


Maximum logical record size 


64 


DSC 




Message class 


26 


84 


54 


Message text 


47 
49 


50 
50 


32 
32 



Appendix A: Fiekt-to-Recoid Cross-Reference 157 



VS2.03.807 
VS2.03.810 
VS2.03.812 





Record 


Offset 


Field Description 


Type 


Dec. 


Hex. 


MF/1 interval duration 


70 


24 


18 




71 


24 


18 




72 


24 


18 




73 


24 


18 




74 


24 


18 


MF/1 interval start date 


70 


20 


14 




71 


20 


14 




72 


20 


14 




73 


20 


14 




74 


20 


14 


MF/1 interval start time 


70 


16 


10 




71 


16 


10 




72 


16 


10 




73 


16 


10 




74 


16 


10 


MF/1 version number 


70 


36 


24 




71 


36 


24 




72 


36 


24 




73 


36 


24 




74 


36 


24 


Model number, channel 


22 


CHAN 




Model number, CPU 


22 


CPU 




Module identification 


19 


62 


3E 


MSF data recording devices 


22 


MSS 




MSF device recording controls 


22 


MSS 




MSF indicator 


22 


MSS 




Name of catalog 


62 


42 


2A 




63 


44 


2C 




64 


40 


28 




67 


40 


28 




68 


38 


26 




69 


52 


34 


Name of component or cluster 


62 


92 


5C 




64 


84 


54 


Name of data set 


17 


40 


28 




18 


40 


28 




18 


84 


54 


Name of device logical 


6 


68 


44 




26 


92 


5C 


Name of entry 


63 


88 


58 




67 


84 


54 




68 


82 


52 




68 


126 


7E 



Name of IPS 



72 



52 



34 



158 OS/VS2 System Management Facilities (SMF) (VS2.03.8 10) 



VS2.03.807 
VS2.03.810 
VS2.03.812 



Field Description 



Name of job 



Name of job class 
Name of line 

Name of program 
Name of programmer 

Name of remote device 

Name of step 

Name of system, if NJP 



Negative acknowledgements to 
write text, number of 

New catalog record 



New catalog record size 

New data set name 

New entry name 

Noise blocks, number of 



Record 


I 


Offset 


Type 


Dec, 


Hex. 


4 


14 


E 


5 


14 


E 


6 


14 


E 


10 


14 


E 


14 


14 


E 


15 


14 


E 


17 


14 


E 


18 


14 


E 


20 


14 


E 


25** 


14 


E (VS2.03.812) 


26 


14 


E 


34 


14 


E 


35 


14 


E 


40 


14 


E 


62 


14 


E 


63 


14 


E 


64 


14 


E 


67 


14 


E 


68 


14 


E 


69 


14 


E 



26* 



172 



AC (VS2.03.812) 



47 
48 
49 


32 
32 
32 


20 
20 
20 


4 
34 


54 
54 


36 
36 


5 

20 

26 


93 
40 
64 


5D 
28 
40 


47 
48 
49 


24 
24 
24 


18 
18 
18 


4 
34 


62 
62 


3E 
3E 


26** 
26** 
26** 


92 

140 

148 


5C (VS2.03.812) 
8C (VS2.03.812) 
94 (VS2.03.812) 


48* 
48** 


52 
58 


34 

3A (VS2.03.812) 


63 
67 


132 
130 


84 
82 


63 
67 


40 
128 


28 
80 


18 


84 


54 


68 


126 


7E 


21 


34 


22 



*These records are for JES2 only. 
* 'These records are for JES3 only. 



Appendix A: Field-to-Record Cross-Reference 159 



VS2.03.807 
VS2.03.810 
VS2.03.812 



Field Description 


Record 
Type 


Offset 
Dec. Hex. 


Non-VIO, non-swap page-ins 


4 

34 
71 
71 


REL 
REL 
48 
84 


30 
54 


Non-VIO, non-swap page-outs 


4 
34 
71 
71 


REL 
REL 
52 
88 


34 
58 


Non-VIO page reclaims 


71 
71 


56 
92 


38 
5C 


Number of address space swap 
sequences 


4 

34 

71 


REL 
REL 
60 


3C 


Number of auxiliary storage page 


71 


124 


7C 



slots allocated to non-VIO address 
spaces in the user pool 



Number of auxiliary storage page 
slots allocated to VIO data sets in 
the user pool 



71 



120 



78 



Number of auxiliary storage page 
slots in the user pool 



71 



116 74 



Number of auxiliary storage page slots 
that have not been allocated 



71 



128 80 



Number of blocks per volume 



14 
15 



TAPD 
TAPD 



Number of buffers allowed per 
terminal before LWAIT 



31 



22 16 



Number of buffers allowed per 
terminal before OWAIT 



31 



20 14 



Number of buffers reserved on 
free queue 


31 


28 


1C 


Number of bus-out checks 


48** 


62 


3E (VS2.03.812) 


Number of bytes in real storage 





27 


1B 


Number of bytes in SMF buffer 





18 


12 


Number of bytes in virtual storage 





22 


16 


Number of cards, input 


26* 
26** 


204 
244 


CC 

F4 (VS2.03.812) 


Number of cards, output punched 


26 


116 


74 


Number of cards generated to spool 


26* 
26** 


212 
252 


D4 

FC (VS2.03.812) 


Number of card-image records in 
DD DATA and DD* data sets read 
for step/job 


4 
5 


47 
47 


2F 
2F 


Number of cleaner actions 


21 


37 


25 


Number of command rejects 


48** 


60 


3C (VS2.03.812) 



•These records are for JES2 only. 
•"These records are for JES3 only. 



160 OS/VS2 System Management Facilities (SMF) (VS2.03.8 10) 



VS2.03.807 
VS2.03.810 
VS2.03.812 



Field Description 



Record 
Type 



Number of copies printed 

Number of cylinders in independent 
index, prime dote, and independent 
overflow areas 

Number of cylinders in largest 
continuous unallocated area 



14 
15 



Offset 
Dec. Hex. 



PR NT 

ISAM 
ISAM 

48 



(VS2.03.810) 



30 



Number of cylinders in largest 
unallocated extent 


19 


52 


34 


Number of data checks to read text 


48* 
48 # * 


56 
64 


38 

40 (VS2.03.812) 


Number of data overruns 


48** 


65 


41 (VS2.03.812) 


Number of data set sequences 


14 
15 


TAPU 
TAPU 





Number of data sets processed by 
writer 



52 



34 



Number of devices requested during 
allocation 


14 
15 


50 
50 


32 
32 


Number of disk volumes fetched 


25** 


44 


2C (VS2.03.812) 


Number of disk volumes mounted 


25** 


68 


44 (VS2.03.812) 


Number of DSCBs 


19 


42 


2A 


Number of DSCBOs 


19 


44 


2C 


Number of equipment checks 


48** 


63 


3F (VS2.03.812) 


Number of erase gaps 


21 


35 


23 


Number of EXCPs 


4 

14 

15 

34 

40 

48 

64 


OEV 

UCB 

UCB 

DEV 

DEV 

48 

STAT 


30 


Number of extents 


14 
15 
64 


UCB 
UCB 
STAT 


i 


Number of extents in independent 
index, prime data, and independent 
overflow areas 


14 
15 


ISAM 
ISAM 




Number of extents released by DADSM 
routine 


14 
15 


DCB 
DCB 




Number of free data space extents 


69 


42 


2A 


Number of full cylinder overflow areas 


14 
15 


ISAM 
ISAM 




Number of interventions required 


48** 


61 


3D (VS2.03.812) 


Number of line errors 


48* 
48** 


64 
52 


40 

34 (VS2.03.812) 



•These records are for JES2 only. 
**These records are for JES3 only. 



Number of lines per page 



26* 



126 



7E 



Appendix A: Field-to-Recoid Cross-Reference 160.1 



VS2.03.807 
VS2.03.810 
VS2.03.812 



•These records are for JES2 only. 
**These records are for JES3 only. 



Field Description 



Number of logical records in overflow 
and prime data areas 

Number of logical records written 

Number of lost datas 

Number of negative acknowledgements 
to write text 

Number of noise blocks 

Number of non-VIO, non-swap page-ins 



Number of non-VIO, non-swap 
page-outs 



Number of non-VIO page reclaims 



Number of output lines 

Number of output lines generated 
to spool 

Number of output punched cards 

Number of page frames available in 
real storage 

Number of page frames defined 
in real storage 



Record 
Type 


Offset 
Dec. Hex. 


14 
15 


ISAM 
ISAM 




6 


47 


2F 


48** 


66 


42 (VS2.03.812) 


48* 
48** 


52 
58 


34 

3A (VS2.03.812) 


21 


34 


22 


4 
34 
71 
71 


REL 
REL 
48 
84 


30 

54 


4 
34 
71 
71 


REL 
REL 
52 
88 


34 
58 


71 
71 


56 
92 


38 
5C 


26 


112 


70 


26* 
26** 


208 
248 


DO 

F8 (VS2.03.812) 


26 


116 


74 


71 


108 


6C 



71 



112 



70 



Number of page seconds 


4 
34 


REL 
REL 




Number of pages in real contiguous 
storage 


22 


STOR 




Number of pages printed 


6 


84 


54 


Number of pages stolen 


4 
34 


REL 
REL 




Number of pages swapped in 


4 

34 

71 


REL 
REL 
64 


40 


Number of pages swapped out 


4 

34 

71 


REL 
REL 
68 


44 


Number of permanent read errors 


21 


32 


20 


Number of permanent write errors 


21 


33 


21 


Number of read or write accesses to 
an overflow record 


14 
15 


ISAM 
ISAM 





(VS2.03.807) 
(VS2.03.807) 



(VS2.03.807) 
(VS2.03.807) 



160.2 OS/VS2 System Management Facilities (SMF) (VS2.03.810) 



VS2.03.807 
VS2.03.810 
VS2.03.812 



Field Description 



Record 
Type 



Offset 
Dec. Hex. 



Number of reclaims 

Number of records deleted, inserted, 
updated, and retrieved from component 

Number of records in component 

Number of records lost 

Number of requests enqueued for 
this device 

Number of requests serviced on this 
device 

Number of samples 

Number of split control areas 
Number of split control intervals 
Number of START l/Os 

Number of step 

Number of steps in job 
Number of swap sequences 

Number of tape volumes fetched 
Number of tape volumes mounted 
Number of temporary read errors 
Number of temporary write errors 
Number of terminal input lines 

Number of terminal output lines 

Number of time-outs to read text 

Number of time-sharing buffers 
Number of tracks allocated on device 



Number of tracks in largest unallocated 
extent 

Number of tracks in largest continuous 
unallocated area 

Number of tracks in overflow area 



4 
34 

64 



64 

7 
74 

74 

73 
74 

64 

64 

21 
73 

4 

34 

40 

5 
35 

4 

34 

71 

25* • 

25** 

21 

21 

34 
35 

34 
35 

48* 
48** 

31 

14 
15 

19 
69 



14 
15 



REL 
REL 

STAT 



STAT 

14 E 

DEVD 



DEVD 

32 
32 

STAT 

STAT 

30 
CHND 

38 
38 
38 

38 
38 

REL 
REL 
60 

40 

64 

28 

29 

47 
47 

43 
43 

60 
56 

14 

UCB 
UCB 

54 
50 



(VS2.03.807) 
(VS2.03.807) 



20 
20 



1E 



26 
26 
26 

26 
26 



3C 

28 (VS2.03.812) 

40 (VS2.03.812) 

1C 

1D 

2F 

2F 

2B 
2B 

3C 

38 (VS2.03.812) 



36 



32 



ISAM 
ISAM 



Appendix A: Field-to-Record Cross-Reference 160.3 



VS2.03.807 
VS2.03.810 
VS2.03.81 2 



Field Description 



Number of tracks released by DADSM 14 
routine 



Number of tracks requested but not 
allocated 

Number of transactions 



Number of unallocated extents 
Number of unallocated cylinders 

Number of unallocated tracks 

Number of unused alternate tracks 
Number of unused control intervals 
Number of VIO page reclaims 

Number of VIO page-ins 
Number of VIO page-outs 

Number of volumes 

Old catalog record 
Old catalog record size 
Old data set name 
Old entry name 
OPEN routine indicator 

Open status indicator 
OPTCD=J 
Options, SMF 
Output form number 
Output lines, number of 

Output lines generated to spool, 
number of 

Output priority 



Record 


Offset 


Type 


Dec. 


Hex. 


14 


OCB 




15 


DCB 




64 


128 


80 


35 


84 


54 


72 


PERF 




19 


56 


38 


19 


48 


30 


69 


44 


2C 


19 


50 


32 


69 


46 


2E 


19 


46 


2E 


64 


STAT 




71 


80 


50 


71 


104 


68 


4 


REL 




34 


REL 




71 


72 


48 


71 


96 


60 


4 


REL 




34 


REL 




71 


76 


4C 


71 


100 


64 


17 


87 


57 


18 


131 


83 


62 


136 


88 


63 


132 


84 


63 


42 


2A 


18 


40 


28 


68 


82 


52 


14 


245 


F5 


15 


245 


F5 


62 


38 


26 


6 


PR NT 


(VS2.03.810) 





26 


1A 


26* 


120 


78 


26 


112 


70 


26* 


208 


DO 


26* • 


248 


F8 (VS2.03.812) 



90 



5 A (VS2.03.812) 



'These records are for JES2 only. 
**These records are for JES3 only. 



160.4 OS/VS2 System Management Facilities (SMF) (VS2.03.8 10) 



VS2.03.807 
VS2.03.810 
VS2.03.812 





Record 


Offset 


Field Description 


Type 


Dec. 


Hex. 


Output processor (CPU) identification 


26* 
26* * 


228 
268 


E4 

10C (VS2.03.812) 


Output processor start time and date 


26* 
26** 


184 
224 


DO 

E0 (VS2.03.812) 


Output processor stop time and date 


26* 
26** 


192 
232 


CO 

E8 (VS2.03.812) 


Output punched cards, number of 


26 


116 


74 


Output route code 


6* 


88 


58 


Output selection priority 


26* 
26 * 


88 
89 


58 
59 


Output service start date 


26** 


43 


2B (VS2.03.812) 


Output service start time 


26** 


39 


27 (VS2.03.812) 


Overlay name 


6 


PRNT 


(VS2.03.810) 


OWAIT threshold 


31 


24 


18 


Owner identification of direct access 


19 


22 


16 


volume 








Page frames available in real storage 


71 


108 


6C 


Page frames defined in real storage 


71 


112 


70 


Page reclaims, non-VIO 


71 
71 


56 
92 


38 
5C 


Page reclaims, VIO 


71 
71 


80 
104 


50 
68 


Page seconds 


4 
34 


REL 
REL 


(VS2.03.807) 
(VS2.03.807) 



Page slots allocated to non-VIO address 
spaces in the user pool 

Page slots allocated to VIO data sets 
in the user pool 

Page slots in the user pool of paging 
data sets 

Page slots that have not been allocated 

Page-ins, non-VIO, non-swap 



Page-ins, VIO 



Page : outs, non-VIO, non-swap 



71 



71 



71 



71 



124 



120 



116 



128 



7C 



78 



74 



80 



4 


REL 




34 


REL 




71 


48 


30 


71 


84 


54 


4 


REL 




34 


REL 




71 


72 


48 


71 


96 


60 


4 


REL 




34 


REL 




71 


52 


34 


71 


88 


58 



*These records are for JES2 only. 
**These records are for JES3 only. 



Appendix A: Field-to-Recoid Cross-Reference 160 J 



VS2.03.807 
VS2.03.810 
VS2.03.812 





Record 


Offset 


Field Description 


Type 


Dec. 


Hex. 


Page-outs, VIO 


4 


REL 






34 


REL 






71 


76 


4C 




71 


100 


64 


Pages, number in real contiguous 


22 


STOR 




storage 









Pages, number of printed 
Pages swapped in, number of 

Pages swapped out, number of 

Password 

Performance group number 



Performance group number, highest 
defined in IPS 

Permanent read errors, number of 

Permanent write errors, number of 

Print copy count, job 

Print route code, job 

Print/punch processor start date 

Print/punch processor start time 

Priority, address space dispatching 

Priority, job 

Priority, job selection 

Priority, logon 

Priority, output selection 



Private area, storage used from 
bottom of 

Private area, storage used from top of 



Private area size 



72 



35 



84 



50 



53 



54 



4 


REL 




34 


REL 




71 


64 


40 


4 


REL 




34 


REL 




71 


68 


44 


47 


40 


28 


48 


40 


28 


49 


40 


28 


4 


REL 




5 


88 


58 


34 


REL 




35 


88 


58 


72 


30 


1E 



32 



21 


32 


20 


21 


33 


21 


26* 


124 


7C 


26* 


128 


80 


6* 


43 


2B 


6* 


39 


27 


4 


53 


35 


34 


53 


35 


5 


53 


35 


35 


53 


35 


26 


86 


56 


26 


87 


57 



35 



6** 
26* 
26* 


90 
88 
89 


5 A (VS2.03.812) 

58 

59 


4 
34 


74 
74 


4A 
4A 


4 
34 


72 
72 


48 
48 


4 
34 


70 
53 


46 
35 



"These records are for JES2 only. 
* "These records are for JES3 only. 



160.6 OS/VS2 System Management Facilities (SMF) (VS2.03.8 1 0) 



VS2.03.807 
VS2.03.810 
VS2.03.812 



•These records are for JES2 only. 
••These records are for JES3 only. 



Field Description 



Procedure DDNAME 
Procedure name, JES3 
Program name 

Program start time 

Programmers accounting number 
Programmers name 

Programmers room number 

Punch route code, job 

Punched cards, number of 

Punched cards generated to spool, 
number of 

RBA, highest used 

Read errors, number of 

Read or write accesses to an overflow 
record, number of 

Reader device class 

Reader end date 

Reader end time 

Reader start date 



Record 


Offset 


Type 


Dec. 


Hex. 


26 


132 


84 


43* » 


34 


22 (VS2.03.812) 


4 


54 


36 


34 


54 


36 


4 


90 


5A 


34 


90 


5A 



26* 



64 

21 
21 

14 
15 



100 



64 



5 


93 


5D 


20 


40 


28 


26 


64 


40 


26* 


104 


68 


26* 


130 


82 


26 


116 


74 


26* 


212 


D4 


26* • 


252 


FC (VS2.03.812) 



130 

28 
32 

ISAM 
ISAM 

69 



82 

1C 
20 



45 



5 


58 


3A 


26* 


148 


94 


26** 


188 


BC (VS2.03.812) 


5 


54 


36 


26* 


144 


90 


26** 


184 


B8 (VS2.03.812) 


4 


26 


1A 


5 


26 


1A 


6 


26 


1A 


10 


26 


1A 


14 


26 


1A 


15 


26 


1A 


17 


26 


1A 


18 


26 


1A 


20 


26 


1A 


25** 


26 


1A (VS2.03.812) 


26 


26 


1A 


40 


26 


1A 


62 


26 


1A 


63 


26 


1A 


64 


26 


1A 


67 


26 


1A 


68 


26 


1A 


69 


26 


1A 



Appendix A: Field-to-Record Cross-Reference 160.7 



VS2.03.807 
VS2.03.810 
VS2.03.812 



* 'These records are for JES3 only. 



Field Description 



Reader start time 



Reader unit type 

Real storage, number of bytes in 

Record format 

Record indicator 



Record 


Offset 


Type 


Dec. 


Hex. 


4 


22 


16 


5 


22 


16 


6 


22 


16 


10 


22 


16 


14 


22 


16 


17 


22 


16 


18 


22 


16 


20 


22 


16 


25** 


22 


16 (VS2.03.812) 


26 


22 


16 


40 


22 


16 


62 


22 


16 


63 


22 


16 


64 


22 


16 


67 


22 


16 


68 


22 


16 


69 


22 


16 



Record size, maximum logical 

Records, logical, number written 

Records deleted, inserted, updated, and 
retrieved from component, number of 

Records in component, number of 

Records in overflow and prime data 
areas, number of logical 

Record type 

Records lost, number of 

Relative address of JFCB or SIOT 



Relative address of last record 
processed for a physical sequential 
or partitioned data set 

Relative byte address, highest used 



64 



70 



27 



STAT 



46 



1B 



14 


242 


F2 


15 


242 


F2 


4 


98 


62 


14 


38 


26 


15 


38 


26 


22 


14 


E 


34 


98 


62 


40 


40 


28 


47 


20 


14 


48 


20 


14 


49 


20 


14 


63 


38 


26 


67 


38 


26 


64 


DSC 




6 


47 


2F 


64 


STAT 





14 


ISAM 




15 


ISAM 




ALL 


1 


1 


7 


14 


E 


14 


60 


3C 


14 


60 


3C 


14 


DCB 




15 


DCB 





64 



130 



82 



160.8 OS/VS2 System Management Facilities (SMF) (VS2.03.810) 



VSZ.UJ.SU/ 

VS2.03.810 
VS2.03.812 



Field Description 


Record 
Type 


Offset 
Dec. Hex. 


Release number of operating system 


70 
71 
72 
73 
74 


40 
40 
40 
40 
40 


28 
28 
28 
28 
28 


Remote name 


47 
48 
49 


24 
24 
24 


18 
18 
18 


RESTART threshold 


31 


26 


1A 


Room number, programmers 


26* 


104 


68 


Route" code 


6* 
26* 
26* 
26* 


88 
90 
128 
130 


58 
5A 
80 
82 


Samples, number of MF/1 


73 
74 


32 
32 


20 
20 


Sampling cycle length 


73 
74 


28 
28 


1C 
1C 


Service, job 


5 

35 

72 


76 
76 
PERF 


4C 
4C 


Service, step 


4 

34 

72 


REL 
REL 
PERF 




SID parameter 


ALL 


10 


A 


Situation indicator 


64 


38 


26 


SIOT TTR address 


14 
15 


60 
60 


3C 
3C 


Size of catalog record 


63 
63 
67 


40 
42 
128 


28 
2A 
80 


Size of control interval 


64 


DSC 




Size of private area 


4 
34 


70 
70 


46 
46 


Size of terminal status block 


31 


32 


20 


Size of time-sharing buffer 


31 


16 


10 


SMF options 





26 


1A 


Spindle identification 


64 
69 


EXT 
40 


28 


SSID of device 


22 


VAR 




Staging adapters 


22 


MSS 




Staging spindles in staging data 


22 


MSS 





groups 



Start date of recording when SMF data 
set became available 



20 



14 



'These records are for JES2 only. 



Appendix A: Field-to-Record Cross-Reference 160.9 



VS2.03.807 
VS2.03.810 
VS2.03.812 



Field Description 



Record 
Type 



Offset 
Dec. Hex. 



START l/Os, number of 

Start time of recording when SMF 
data set became available 

Start/warm start indicator 

Step accounting fields 

Step completion code 

Step CPU time 



Step name 
Step number 

Step performance group number 

Step service 

Step termination date 

Step termination indicator 

Step termination time 

Step transaction active time 

Step transaction residency time 

Storage, real, number of bytes in 

Storage, used from bottom of 
private area 

Storage, used from top of private area 

Storage, virtual, number of bytes in 
Storage protect key 



21 
73 



43 



30 1E 

CHND 



16 



22 



27 



10 



16 



4 
34 


ACT 
ACT 




4 
34 


51 
51 


33 
33 


4 
4 
34 
34 


95 
ACT 
95 
ACT 


5F 
5F 


4 
34 


62 
62 


3E 
3E 


4 

34 

40 


38 
38 
38 


26 
26 
26 


4 
5 

34 
35 


ret. 

88 

REL 

88 


58 
58 


4 
34 


REL 
REL 




4 
34 


6 
6 


6 
6 


4 
34 


83 
83 


53 
53 


4 
34 


2 
2 


2 
2 


4 
34 


REL 
REL 




4 
34 


REL 
REL 


(VS2.03.807) 
(VS2.03.807) 



1B 



4 


74 


4A 


34 


74 


4A 


4 


72 


48 


34 


72 


48 





22 


16 


4 


82 


52 


5 


72 


48 


34 


82 


52 


35 


72 


48 



160.10 OS/VS2 System Management Facilities (SMF) (VS2.03.810) 



VS2.03.807 
VS2.03.810 
VS2.03.812 



Field Description 



Subsystem identification 



Subsystem identification of device 
Swap sequences, number of 

Swap-ins, number of 

Swap-outs, number of 

SYSOUT class 
System identification 

System identification from $E SYS 
command 

System indicator 

System name (if NJP) 

System release number 



Tape density 

Tape volumes fetched, number of 
Temporary read errors, number of 
Temporary write errors, number of 
Terminal input lines, number of 

Terminal output lines, number pf 

Terminal status block, size of 
Termination indicator, JES2 or JES3 
Termination indicator, job 

Termination indicator, step 

TGETs satisfied, number of 



Record 


Offset 


Type 


Dec. 


Hex. 


6 


58 


3A 


26 


42 


2A 


43 


14 


E 


45 


14 


E 


47 


14 


E 


48 


14 


E 


49 


14 


E 


22 


VAR 




4 


REL 




34 


REL 




71 


60 


3C 


4 


REL 




34 


REL 




71 


64 


40 


4 


REL 




34 


REL 




71 


68 


44 


6 


38 


26 


ALL 


10 


A 


43* 


24 


18 



*These records are for JES2 only. 
**These records are for JES3 only. 



ALL 

26** 
26** 
26** 

70 
71 
72 
73 
74 

21 

25** 

21 

21 

34 
35 

34 
35 

31 

45 

5 
35 

4 
34 

34 
35 



£2 
140 
148 

40 
40 
40 
40 
40 

39 

40 

28 

29 

47 
47 

43 
43 

32 

20 

62 
62 

83 
83 

47 
47 



5C (VS2.03.812) 
8C(VS2.03.812) 
94 (VS2.03.812) 

28 
28 
28 
28 
28 

27 

28 (VS2.03.812) 

1C 

ID 

2F 
2F 

2B 
2B 

20 

14 

3E 
3E 

53 
53 

2F 
2F 



Appendix A: Field-to-Record Cross-Reference 160.11 



VS2.03.807 
VS2.03.810 
VS2.03.812 



Field Description 


Record 
Type 


Offset 
Dec. Hex. 


Time, continuous wait 





14 


E 


Time, CPU wait 


70 


CPUD 




Time, deadline schedule 


26** 


164 


A4 (VS2.03.812) 


Time, execution 


26 


108 


6C 


Time, JES3 allocation 


25** 


72 


48 (VS2.03.812) 


Time, JES3 device verification 


25** 


80 


56 (VS2.03.812) 


Time, job CPU 


5 
5 
35 
35 


73 
113 
73 
113 


49 
71 
49 
71 


Time, logoff 


35 


2 


2 


Time, logon 


34 
35 


22 
22 


16 
16 


Time, logon enqueue 


35 


54 


36 


Time, step CPU 


4 
4 
34 
34 


95 
ACT 
95 
ACT 


5F 
5F 


Time, job transaction active 


5 

35 

72 


80 
80 
PERF 


50 
50 


Time, step transaction active 


4 

34 

72 


REL 
REL 
PERF 




Time "START SETUP command 
issued 


25** 


56 


38 (VS2.03.812) 


Time converter started 


26* 
26** 


152 
192 


98 

CO (VS2.03.812) 


Time converter stopped 


26* 
26** 


160 
200 


A0 

C8 (VS2.03.812) 


Time device allocation started 


4 
34 


86 
86 


56 
56 


Time execution processor started 


26* 
26** 


168 
208 


A8 

DO (VS2.03.812) 


Time execution processor stopped 


26* 
26** 


176 
216 


BO 

D8 (VS2.03.812) 


Time fetch processing started 


25** 


48 


30 (VS2.03.812) 


Time first volume mount message 
issued 


25** 


72 


48 (VS2.03.812) 


Time initiator selected step/job 


4 
5 
34 


39 
39 
39 


27 
27 
27 



•These records are for JES2 only. 
•These records are for JES3 only. 



16ai2 OS/VS2 System Management Facilities (SMF) (VS2.03.810) 



VSZ.UJ.OU/ 

VS2.03.810 
VS2.03.812 



Field Description 



Record 
Type 



Offset 
Dec. Hex. 



Time job terminated 



Time MF/1 interval started 



Time output processor started 

Time output processor stopped 

Time output service started 
Time-outs to read text, number of 

Time print/punch processor started 
Time program started 

Time reader recognized end of job 
Time reader recognized the JOB card 



'These records are for JES2 only. 
••These records are for JES3 only. 

1 Except 2, 3, 4, 5, 34 and 35. 



Time record was moved to dump 
data set 

Time record was moved to SMF buffer 

Time recording was started when SMF 
data set became available 

Time step terminated 

Time-sharing buffer size 
Time-sharing buffers, number of 
TIOT status indicator 

TPUTs issued, number of 



5 
35 

70 
71 
72 
73 
74 

26* 
26* ( 

26* 
26* 4 



48* 
48*' 

6* 



2 
2 

16 
16 
16 
16 
16 

184 
224 

192 
232 

39 

60 
56 

39 



2 
2 

10 
10 
10 
10 
10 

B8 

E0 (VS2.03.812) 

CO 

E8 (VS2.03.812) 

27 (VS2.03.812) 

3C 

38 (VS2.03.812) 

27 



4 


90 


5A 


34 


90 


5A 


5 


54 


36 


26* 


144 


90 


26** 


184 


B8 (VS2.03.812) 


4 


22 


16 


5 


22 


16 


6 


22 


16 


10 


22 


16 


14 


22 


16 


15 


22 


16 


17 


22 


16 


18 


22 


16 


20 


22 


16 


25** 


22 


16 (VS2.03.812) 


26 


22 


16 


40 


22 


16 


62 


22 


16 


63 


22 


16 


64 


22 


16 


67 


22 


16 


68 


22 


16 


69 


22 


16 


2 


2 


2 


3 


2 


2 


ALL 1 


2 


2 


7 


16 


10 


4 


2 


2 


34 


2 


2 


31 


16 


10 


31 


14 


E 


14 


49 


31 


15 


49 


31 


34 


43 


2B 


35 


43 


2B 



Appendix A: Field-to-Record Cross-Reference 160.13 



VS2.03.807 
VS2.03.810 
VS2.03.812 



"These records are for JES3 only. 



Field Description 



Record 
Type 



Offset 
Dec. Hex. 



Tracks, number in largest 
unallocated extent 

Tracks, number of unallocated 



Tracks, number of unused alternate 
Tracks allocated on device, number of 



Tracks in largest continuous 
unallocated area, number of 

Tracks in overflow area, number of 



Tracks released by DADSM routine, 
number of 

Tracks requested but not allocated, 
number of 

Transaction active time, job 



Transaction active time, step 

Transaction residency time, job 

Transaction residency time, step 

Transactions, number of 

TSB (terminal status block), size of 
TSO user identification 
TTRof JFCBorSIOT 



TTRN of last record processed for a 
physical sequential or partitioned 
data set 

Type of deadline schedule 

Type of I/O macro instruction and 
options 

UCS image identification 



19 



19 
69 

19 

14 
15 

69 



64 



26* 

14 
15 



54 



50 
46 

46 

UCB 
UCB 

50 



14 


ISAM 


15 


ISAM 


14 


DCB 


15 


DCB 



128 



120 

243 
243 

80 



36 



32 
2E 

2E 



32 



80 



5 

35 

72 


80 
80 
PERF 


50 
50 


4 

34 

72 


REL 
REL 
PERF 




5 
35 


64 
64 


40 (VS2.03.807) 
40 (VS2.03.807) 


4 
34 


REL 
REL 


(VS2.03.807) 
(VS2.03.807) 


35 
72 


84 
PERF 


54 


31 


32 


20 


26** 


92 


5C (VS2.03.812) 


14 
15 


60 
60 


3C 
3C 


14 
15 


DCB 
DCB 





78 (VS2.03.812) 

F3 
F3 

50 



160.14 OS/VS2 System Management Facilities (SMF) (VS2.03.8 1 0) 



VS2.03.807 
VS2.03.810 
VS2.03.812 





Record 


Offset 


Field Description 


Type 


Dec. 


Hex. 


Unit address 


4 


DEV 






8 


DEV 






9 


DEV 






10 


DEV 






11 


DEV 






14 


UCB 






15 


UCB 






19 


61 


3D 




21 


23 


17 




34 


DEV 






40 


DEV 






64 


EXT 






69 


39 


27 


Unit type 


5 


70 


46 




8 


DEV 






9 


DEV 






10 


DEV 






11 


DEV 






14 


UCB 






15 


UCB 






19 


32 


20 




21 


24 


18 




34 


DEV 






40 


DEV 






62 


VOL 






64 


EXT 






74 


DEVD 




Updated records, number of 


64 


STAT 




User identification 


4 


30 


1E 



VIO page reclaims, number of 



VIO page-ins, number of 



4 


30 


1E 


5 


30 


1E 


6 


30 


1E 


10 


30 


1E 


14 


30 


1E 


15 


30 


1E 


17 


30 


1E 


18 


30 


1E 


20 


30 


1E 


25** 


30 


1E(VS2.03.812) 


26 


30 


1E 


34 


30 


1E 


35 


30 


1E 


40 


30 


1E 


62 


30 


1E 


63 


30 


1E 


64 


30 


1E 


67 


30 


1E 


68 


30 


1E 


69 


30 


1E 


4 


REL 


(VS2.03.807) 


34 


REL 


(VS2.03.807) 


71 


80 


50 


71 
4 


104 
REL 


68 


34 


REL 




71 


72 


48 


71 


96 


60 



••These records are for JES3 only. 



Appendix A: Field-to-Record Cross-Reference 160.15 



VS2.03.807 
VS2.03.810 
VS2.03.812 





Record 


Offset 


Field Description 


Type 


Dec. 


Hex. 


VIO page-outs, number of 


4 


REL 






34 


REL 






71 


76 


4C 




71 


100 


64 


Virtual storage, number of bytes in 





22 


16 


Volume mount message date 


25** 


76 


52 (VS2.03.812) 


Volume mount message time 


25** 


72 


48 (VS2.03.812) 


Volume owner identification 


19 


22 


16 


Volume sequence number 


14 


250 


FA 




15 


250 


FA 


Volume serial number 


14 


UCB 






15 


UCB 






17 


VOL 






18 


VOL 






19 


16 


10 




21 


16 


10 




62 


86 


56 




62 


VOL 






64 


EXT 






69 


96 


60 




74 


DEVD 




Volumes, number of 


17 


87 


57 


Volumes fetched, number of 


25** 


40 


28 (VS2.03.812) 


Volumes mounted, number of 


25** 


64 


40(VS2.03.812) 


VTOC address 


19 


36 


24 


VTOC indicator 


19 


41 


29 


Wait time, CPU 


70 


CPUD 




Warm start/start indicator 


43 


22 


16 


Workload level 


72 


PERF 




Write errors, number of 


21 


29 


1D 




21 


33 


21 



* 'These records are for JES3 only. 



160. 16 OS/VS2 System Management Facilities (SMF) (VS2.03.8 10) 



Appendix B: EXCP Count 



SMF record types 4, 14, 15, 34,40 and 64 have fields that contain the number of 
EXCPs for a given job or job step. The EXCP count in these records equals the 
number of physical records for non-spooled data sets. (The number of logical 
records for spooled data sets appears in SMF record types 6 and 26 only.) This 
appendix summarizes the I/O activity included and that which is excluded in the 
EXCP-count fields of these SMF records. 

The EXCP count includes: 

• EXCPs issued via an EXCP macro (SVC 0) 

• EXCPs issued in a user's channel-end appendage 

• EXCPs issued in a user's abnormal-end appendage 

• I/O for VSAM data sets 

• I/O for VIO data sets 

The EXCP count does not include: 

• EXCPs issued via an EXCPVR macfo (SVC 1 14) 

• EXCPs issued in a user's PCI when ADDRSPC=REAL 

• I/O for system services performed in system keys (0-7), for example: 

— Joblib/steplib processing 

— Jobcat/stepcat processing 

— Overlay supervisor processing 

— Checkpoint data set processing 

• EXCPs handled by the job entry subsystem 

• TPUTs and TGETs handled by macro instructions (For TPUTs and TGETs, 
EXCPs are accumulated on a system basis in the TCT and are contained 

in SMF record types 34 and 35 only.) 
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Notes: 

1 . In SMF record types 14 and 15 , the EXCP count accumulates over the entire job 
step. Therefore, if a data set is opened and closed twice during a single job step, 
the count in the second record is the sum of all EXCPs for both uses of the data 
set. 

2. The EXCP count in the last type 14 and 15 records for a given job step equals the 
corresponding entry for the data set in the type 4 record. 

3. If a concatenated data set contains more than one data set member with the 
same physical device, the EXCP count is accumulated in the first data set entry 
having that device "entry. 

4. If a GETMAIN for the expanding TCTIOT data area (where the EXCP count is 
maintained) fails, only the existing data sets are counted. 

5. In case of system failure, EXCP counting for the job step is discontinued and no 
device entries are produced. 
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Appendix C: CPU Time 



SMF record types 4, 5, 34 and 35 have fields that contain the job and job step CPU 
times which installations use for billing purposes. To assist you in creating billing 
algorithms that use these CPU-time fields, this appendix summarizes the different 
times that are included and those that are excluded. This appendix also lists a few 
examples of some of the major causes of CPU-time variation between different runs 
of the same job or job step. 

Job step CPU time is the amount of time devoted by the central processing unit 
to the execution of instructions for a given job step. Job CPU time is the sum of 
job step CPU times for all of the steps in a given job. For OS/VS2 Release 3.7, 
CPU timing is done by the dispatcher on an address space basis. The accumulation 
of CPU time is separated into two fields: execution time under TCBs and execution 
time under SRBs. 



CPU Time Under TCBs 



When a job step is set dispatchable by the initiator, the accumulated job step time 
field for tasks (ASCBEJST) is initialized to zeros. Task CPU time is determined as 
follows: 

1 . Whenever any task is dispatched, the current TOD value is stored in the 
LCCADTOD field. 

2. Whenever an I/O or external interrupt occurs, the current TOD value is stored 
in the LCCAITOD field. 

3. Whenever the dispatcher selects a new unit of work, the CPU time attributed to 
the pre-emptied task is accumulated in the ASCBEJST field as follows: 

a. If the LCCAITOD f 0, the dispatcher was entered from the interrupt handlers 
and the CPU time for the interrupted task is accumulated by adding the 
difference between the LCCAITOD and LCCADTOD values to the ASCBEJST 
value. 

ASCBEJST = ASCBEJST + (LCCAITOD - LCCADTOD) 

This excludes the interrupt handlers' time from the task time. 

Note: In the case of page faults that result in suspension of the current task, 
the LCCAITOD value represents the TOD value when the program check 
(page fault) occurred. 

b. If LCCAITOD = 0, the dispatcher was entered from Exit Prologue (that is, an 
SVC WAIT was issued) and there has been no interrupt since the task was 
dispatched. If the current task is no longer dispatchable or if it is pre-emptied 
for higher priority work: 1) the current TOD value is stored in the 
ASCBEWST field, and 2) the difference between the ASCBEWST and 
LCCADTOD values is added to the ASCBEJST value. 

ASCBEJST = ASCBEJST + (ASCBEWST - LCCADTOD) 

In both a and b above, the ASCBEJST value is updated via CDS for MP 
serialization. 
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Note: If the current task is the RCT task, CPU time is not accumulated. This 
eliminates the time that is spent in swap-out/swap-in processing and its purging 
of I/O. 

CPU timing is continually accumulated as described above until the job step 
terminates. At that time the CPU time in the ASCBEJST field is moved into the 
ACTJTIME field in the account control tables of the JCT. It is from this field that 
SMF obtains the "CPU time under TCBs" value for its records. 



Included/Excluded TCB Times 

Timing values accumulated by the dispatcher for the address space under TCB 
control include: 

• Problem program time 

• SVCs 

• Page faults resolved by reclaim 

• Program check handling 

• Lock spins encountered in an MP environment 

• EMS (emergency signals between CPUs) interrupt occuring within a lock spin 

• Abend/ Abterm 

Times excluded are: 

• I/O interrupt time 

• External interrupt time 

• Page fault processing if not resolved by reclaim 

• PCFLIH time if valid SPIE in effect 

• CPU "stopped" time if START/STOP commands used 

• Time spent in active DSS breakpoints 

• RCT time (swap-out/swap-in processing) 

• Attention processing time for TSO 



CPU Time Under SRBs 



When a job step is set dispatchable by the initiator, the accumulated job step time 
field for SRBs (ASCBSRBT) is initialized to zeros. SRB time is determined as 
follows: 

1 . Whenever the SRB is dispatched, the current TOD value is stored in the 
LCCADTOD field. 

2. Whenever the SRB terminates: 1) the current TOD value is stored in the 
ASCBEWST field, and 2) the difference between the ASCBEWST and 
LCCADTOD values is added to the ASCBSRBT value. 

ASCBSRBT = ASCBSRBT + (ASCBEWST - LCCADTOD) 
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3. If an SRB is suspended for a page fault, the local lock, or the CMS lock, CPU 
time is accumulated as described in 2 above. Whenever the suspended SRB is 
redispatched, CPU timing is done as described in 1 above. 

Note: Because SRBs are non-preemptible, except for the events described in 3 
above, the time spent in the interrupt handlers is included. 

CPU timing is continually accumulated until the job step terminates. At that time 
the CPU time in the ASCBSRBT field is moved into the SCTSRBT field for use by 
SMF. 



Included/Excluded SRB Times 

Timing values accumulated by the dispatcher for the address space under SRB 
control include: 

• Page resolution 

• Swap control 

• Cross-memory communications 

• TQE scheduling 

• I/O completion processing 

Times excluded are: 

• Page fault suspension 

• Lock request suspension 



CPU-Time Variation 



There are many contributing factors prohibiting repea table CPU-time measurement. 
Following is a list of examples of some of the major causes of variation: 

• Cycle stealing on systems with integrated channels (370/1 25-1 58) - CPU 
instruction execution is temporarily suspended when channels require the use of 
hardware resources shared with the CPU. 

• CPUs using a high speed buffer (370/1 55-1 95) — CPU time may vary due to any 
of the following: 

— Buffer interference caused by concurrent tasks 

— Partial or full disabling of a buffer because of storage errors 

— Page table lookaside buffer affect on MIPS or instruction speed 

• Storage access — The CPU cannot access real storage if a channel is using it. 
Storage-access time depends on CPU architecture such as interleaving, data 
widths and paths. 

• DASD space allocation - If the number of extents is not exactly the same as 
before, additional end-of -extent processing is required. 
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• Temporary I/O errors - Additional SVCs such as SVC 1 5 (ERREXCP), SVC 1 6 
(PURGE), and SVC 55 (EOV) may be required for temporary I/O errors. 

• EXCP request (SVC 0) - The time to process an EXCP request varies depending 
on the availability status of the requested device and channel. Some 
possibilities are : 

(a) The device and primary channel are available — the SIO preparation and 
execution are done immediately. 

(b) The device is available, the primary channel is busy, but one of the alternate 
channels is available - the time to test alternate channels is added to the 
time required in (a). 

(c) All devices and channels are busy - the request must be queued on a FIFO 
basis. 

(d) In an MP environment, the device is available but there are no channels or 
the channels from one CPU are busy— that CPU will issue a SIGP macro 
to signal the other CPU. 

• BLDL/FIND requests - If BPAM is used extensively, CPU time for processing 
BLDL/FIND requests varies if there was a change in the PDS directory. That is, 
a change in the location of the entry for the required member is reflected by a 
change in the time needed to find the block containing it. 

• STOW processing — A difference in the PDS directory may also vary STOW 
processing time because of the additional reordering or bumping that may be 
necessary. 

• Macro processing - Processing time for macros such as LINK, LOAD, XCTL, 
ATTACH and BLDL is affected by where the requested module is located. For 
example, CPU time may be less if the module is in the LPA and job libs and 
steplibs are not used. 

• Availability of serially reusable resources (locks) - System ENQ routine time will 
vary depending on whether the resource is available. If a resource is not available, 
additional time is taken to queue up the current request and to wake the 
requester. DEQ time also increases if other tasks have subsequently requested 
the resource that the current task is releasing. 

• Wait processing - CPU time varies depending on whether or not ECBs have been 
posted prior to issuance of the WAIT macro instruction. 

• Lock spins — If a job is run on an MP, CPU time may vary due to lock spins 
encountered in supervisor services. 

• Queue searching — System service time varies with the status of the queue 
environment. For instance, the time to process an ENQ request varies with the 
number of QCBs to be examined and chained, and whether or not storage must 
be obtained for new QCBs. The time to process a GETMAIN request varies with 
the length of the FQE chain; FREEMAIN time varies with the status (free or 
allocated) of the adjacent areas. Also, global queue searching affects SVC time; 
for example, GETMAIN is greatly affected if storage is fragmented. 

• Time requests — For task and real time requests, timer ENQ routine processing 
time varies with the number of elements on the timer queue that must be 
checked to find the proper slot for the current request. 
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• WTO, WTOR and WTL processing - CPU time may vary depending on the time 
required to find a free WQE and/or RQE, and possibly on whether a 
GETMAIN is necessary to build a new element. If the WTO or reply elements 
are at their limit, additional time is required for enqueuing. 

• Generalized trace facility (GTF) — When GTF is active, CPU time increases 
depending on the system functions (SVC, SIO, 10, PCI, DSP) that are selected 
for current GTF recording. If USR functions are to be recorded and the 
application contains GTRACE macros, the CPU time variability is even more 
pronounced. 

• FREEMAIN resulting in available real page - When a FREEMAIN results in 
making a real page available to an MP system, the page must be invalidated and 
both CPUs' translation lookaside buffers must be purged of the entry. The 
invalidation and purge are synchronous: one CPU may wait (spin) a variable 
amount of time until the other CPU is enabled to receive a signal 

(EMS interrupt) and perform the synchronizing function. 

• System resource manager (SRM) — SRM is run either scheduled as an SRB, as a 
subroutine of quiesce (RCT), or as a subroutine of a service invoked by a job. 
SRM execution may cause CPU time to vary when it is invoked from services 
such as ENQ, WAIT (LONG=YES option), STIMER, WTOR, TPUT and TGET. 

• SRM page stealing - SRM page stealing affects the number of page faults that 
a particular job incurs. CPU time varies depending on both the number of page 
faults resolved by I/O and the number of page faults resolved by reclaim. 



Appendix C: CPU Time 167 



168 0S/VS2 System Management Facilities (SMF) 



Index 



tt 4 

{} 4 

[] 4 

I 4 

$E LNEn operator command 

records written when issued 122, 123 
$E SYS operator command 

record written when issued 120 
$P JES2 operator command 

record written when issued 121 
$P LNEn operator command 

record written when issued 123 
$S LNEn operator command 

record written when issued 122 

accounting field-format 51 

accounting records 14 

adding devices to configuration 91, 92, 105 

adding exit routines to operating system 23 

addressing SMF record fields 48 

allocating space for SMF data sets 27 

allocation 

dynamic 78 

JES3 device 107.1 (VS2.03.812) 

recovery 92 
allocation recovery record (type 10) 92 
ALTER access method services command 

records written when issued 126, 133 
altering VSAM catalog entries 126 
AMS commands {see commands, access method services) 
ASMFCL procedure 

sort procedure, use in 69 

TESTEXIT procedure, use in 63 
auxiliary storage requirements 25 

BUF parameter 34 
buffer, SMF 

specifying size of 34 

storage requirements 25 

CANCEL operator command 

relation to allocation recovery record (type 10) 92 

relation to step termination record (type 4) 78 
canceling an RJP line, JES3 123.1 (VS2.03.812) 
cataloged procedures 

ASMFCL 

sort procedure, use in 69 
TESTEXIT procedure, use in 63 

defining installation data sets in 43 

expanding before IEFUJV receives control 50 
cataloging SMF data sets 27 
channel activity record (type 73) 141 
clock, CPU 100 

closing magnetic tape volumes 103 
closing non-VSAM data sets 94, 97 
closing VSAM components or clusters 128 
cluster 

closing 128 

deleting 131 

opening 125 

renaming 133 
coding examples {see JCL examples) 
cold start 

JES3 record written for 120.1 



commands, access method services 
ALTER 126, 134 
DEFINE 131, 134 
DELETE 126, 133 
commands, operator 
$E LNEn 

records written when issued 122, 123 
$ESYS 

record written when issued 120 
$P JES2 

record written when issued 121 
$P LNEn 

record written when issued 123 
$S LNEn 

record written when issued 122 
CANCEL 78, 92 
HALT 

operation 30 

record written when issued 100 
MODIFY team 

record written when issued 111 
SJES2 

record written when issued 120 
SET DATE 

record written when issued 90 
START 

use with dump procedure 30 
STOP 

records written when issued 135, 137 
SWITCH 

operation 30 

record written when issued 100 
VARY CH 

record written when issued 105 
VARY CPU 

record written when issued 105 
VARY OFFLINE 

records written when issued 93, 105 
VARY ONLINE 

records written when issued 9 1 , 105 
VARY STOR 

record written when issued 105 
common exit parameter area 45 

storage requirements 25 
common service area (CSA) 

SMF storage requirements for 25 
sub pools in 46 
communication among exit routines 46 
component 
closing 128 
deleting 131 
opening 125 
renaming 133 
concatenation request 

record written when issued 118 
configuration 

adding devices to 9 1 , 9 2 , 1 05 
removing devices from 93, 105 
configuration records 

direct access volumes (type 19) 100 
I/O (type 8) 90 
MSS (type 22) 105 
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configuration records (continued) 

VARYCH 105 

VARY CPU 105 

VARY OFFLINE (type 11) 93 

VARY ONLINE (type 9) 91 

VARY STOR 105 
converter 49 

CPU activity record (type 70) 135 
CPU clock 100 
CPU time 163 
CPU time limits 53 
CSA (common service area) 

SMF storage requirements for 25 

sub pools in 46 

data lost record (type 7) 89 
data set activity records 

INPUT or RDBACK (type 14) 94 

OUTPUT, UPDAT, INOUT or OUTIN (type 1 5) 97 
data set records 15 
data set status records 

rename (type 1 8) 99 

scratch (type 17) 98 
data set/direct access volume parameter (DSV) 34, 36 
data sets 

DDDATA 78,112 

DD* 78,112 

installation-defined 43 

non-VSAM 94-99 

SMF (see SMF data sets) 

spin 86 

spin 88.1 (VS2.03.812) 

SYSOUT 55,86,108 

VSAM 125-133 
data-collection parameters 

data set/direct access volume (DSV) 34, 36 

SMF/user records (MAN) 34, 36 

system/job/step (OPT) 35, 36 

temporary data set (REC) 35, 36 
DD DATA data sets 78,112 
DD* data sets 78,112 
deconcatenation request 

record written when issued 118 
DEFINE access method services command 

records written when issued 1 26, 1 34 
defining the use of SMF 33 
defining VSAM catalog entries 1 26 
defining VSAM data spaces 1 34 
DELETE access method services command 

records written when issued 1 31 , 1 34 
deleting VSAM catalog entries 1 31 
deleting VSAM data spaces 1 34 
demounting user volumes 100 
designing a report program 70 
device activity record (type 74) 143 

device allocation record, JES3 (type 25) 107.1 (VS2.03.812) 
device allocation recovery record (type 10) 92 
devices 

direct access 100 

online at IPL 105 

recovering 92 

varying offline 93, 105 

varying online 91,105 
direct access volume record (type 19) 100 
direct access volume/data set parameter (DSV) 34, 36 
distribution libraries 

for adding exit routines 23 
DSV parameter 34, 36 

dump exit routine (see IEFU29 exit routine) (VS2.03.807) 
dump header record (type 2) 76 
dump program, SMF (see IFASMFDP) 



dump trailer record (type 3) 77 
dynamic DD record (type 40) 118 

end-of-volume 

records written at 

for magnetic tape volumes 103 
for non-VSAM data sets 94, 97 
for VSAM catalog entries 1 26 
error statistics by volume record (type 21) 103 
event recording (see also IEFUTL, IEFUSO and IEFU83 
exits) 20 
examples (see also JCL examples) 

data set space requirements 27 

SMF in operating system 17 

SMFFRMT output 70 
EXCP count 161 
exit parameter (EXT) 34 
exit routines, SMF 

adding to operating system 23 

characteristics of 39 

common parameters 45 

communicating among 46 

conventions 43 

facilities 45 

IEFACTRT (termination) 57 

IEFUJI (job initiation) 51 

IEFUJP (job purge) 59 

IEFUJV (job validation) 49 

IEFUSI (step initiation) 52 

IEFUSO (SYSOUT limit) 55 

IEFUTL (time limit) 53 

IEFU29 (SMF dump) 59 (VS2.03.807) 

IEFU83 (SMF record) 56 

introduction to 19,39 

load module assignments for 23 

modules interfacing with 40 

obtaining additional work areas for 46 

parameters passed to 40 

restrictions 43 

return codes 40 

sample routines 41 

storage requirements 25 

testing 59 

using installation-defined data sets with 43 

when taken 40, 19 

writing to SMF-defined data sets from 47 
EXT parameter 34 
extending VSAM catalog entries 1 26 
extending VSAM data spaces 1 34 
external writer 

record written by 86 

GETMAIN macro instruction 46, 60 



100 



120 



HALT operator command 

function 30 

record written when issued 
HASPINIT 

record written by 
HASPMISC 

records written by 
HASPNUC 

record written by 
HASPPRPU 

record written by 
HASPRSCN exit 50 
HASPRTAM 

records written by 
header, standard SMF record 
hot start 

JES3 record written for 120.1 (VS2.03.812) 



108,120 
121 



86 



122-124 
71 
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I/O configuration record (type 8) 90 
I/O macro instruction (SMFWTM) 

format 47 

RDW used with 47,71 

return codes 48 

TESTEXIT definition of 61 
IASXSD82 

record written by 86 
IATINTK 

records written by 1 20.1 ,121.1 (VS2.03.8 12) 
IATOSWD 

record written by 88.1 (VS2.03.812) 
IATPURG 

records written by 107.1,110.1 (VS2.03.812) 
IATRJM3 

records written by 122.1, 123.1, 124.1 (VS2.03.812) 
ICB2MSG 

records written by 91,93,105 
IDA0192A 

record written by 1 25 
IDA0192S 

records written by 1 25 , 1 28 
IDA0200B 

record written by 1 28 
IDA0231B 

record written by 1 28 
IDA0557A 

record written by 1 28 
IEBDG utility program 

creating sample parameter lists with 63, 60 
IEBPTPCH utility program 

use in obtaining listings of 
sample exit routines 41 
sample sort exit routines 68 
TESTEXIT 62 
IEBUPDTE utility program 

adding exit routines to EXITLIB with 62 

adding SMFPRMxx to SYS1 .PARMLIB with 37 

executing SMF dump program with 30 

executing TESTEXIT with 63 
IEECLEAN 

records written by 91, 93,1 05 
IEEMB823 

records written by 75, 90, 1 05 
IEEMB829 

record written by 89 
IEEMPVST 

record written by 105 
IEESMFI2 

record written by 102 
IEEVPTH 

records written by 91 , 93 
IEE23Q3D 

record written by 91 
IEFAB421 

record written by 93 
IEFAB488 

record written by 92 
IEFACTRT exit routine 57 

parameters passed 57 

return codes 58 

sample routine 42 

writing system output messages 57 
IEFDB4F9 

record written by 118 
IEFTB722 

records written by 

job termination 83, 1 16 
step termination 78, 112 



IEFUJ I exit routine 51 

parameters passed 5 1 

return codes 52 

sample routine 41 
IEFUJP exit routine 59 

parameters passed 59 

return codes 59 
IEFUJV exit routine 49 

parameters passed 50 

return codes 51 

sample routine 41 
IEFUSI exit routine 52 

parameters passed 52 

return codes 52 
IEFUSO exit routine 55 

parameters passed 56 

return codes 56 
IEFUTL exit routine 5 3 

parameters passed 55 

return codes 55 

sample routine 41 
IEFU29 exit routine 59 (VS2.03.807) 

parameters passed 59 (VS2.03.807) 

return codes 59 (VS2.03.807) 

sample routine 42 (VS2.03.807) 
IEFU83 exit routine 56 

parameters passed 59 

return codes 59 

sample routine 42 
IEHUCAT utility program 33, 1 26, 1 31 
IFASMFDP dump program 

introduction 20 

records written by 76, 77 

sample JCL for executing 29 

sample procedure using START command 30 
IFASMFR macro instruction 48 
IFG0202H 

records written by 94, 97 
IFG0202I 

records written by 94, 97 
IFHSTATR utility program 103 
IGC0005I 

record written by 93 
IGC0009A 

record written by 1 03 
IGC0012F 

recordwrittenby 105 
IGC0107H 

record written by 1 00 
IGC0905I 

record written by 93 
IGG0CLBV 

records written by 

VSAM data space defined, extended or 

deleted (type 69) 134 
VSAM entry denned (type 63) 1 26 
VSAM entry deleted (type 67) 1 31 
VSAM entry renamed (type 68) 1 33 
IGG0290D 

record written by 98 
IGG03001 

record written by 99 
IKJGG001 

record written by 111 
including exit routines in operating system 23 
initial program load (see IPL) 
initialization 

SMF 17 

TIOC 111 
initiation record 

job (type 20) 102 
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initiator 51,52 

INOUT, OUTPUT, UPD AT or OUTIN data set activity 

record (type 15) 97 
INPUT or RDBACK data set activity record (type 14) 94 
input/output (see I/O) 
installation-defined data sets 43 
installation-written routines (see user-written routines) 
integrity 

JES2 record for 124 

JES3 record for 1 24. 1 (VS2.03.8 12) 
interlock warning 5 3 
interpreter 49 
IPL records 

configuration (type 22) 105 

direct access volume (type 19) 100 

I/O configuration (type 8) 90 

IPL (type 0) 75 
IRBMFDCP 

record written by 1 35 
IRBMFDDP 

record written by 143 
IRBMFDHP 

record written by 141 
IRBMFDPP 

record written by 1 37 
IRBMFDWP 

record written by 1 39 

JCL examples 

adding exit routines to EXITLIB 62 

adding exit routines to SYS1 .LPALIB 24 

adding SMFPRM01 to SYS1.PARMLIB 37 

allocating space for SMF data sets 27 

cataloging SMF data sets 27 

dumping SMF data sets using START command 30 

executing SMF dump program 29 

executing SMFFRMT 70 

executing a sort procedure 68 

executing TESTEXIT 63 

obtaining a listing of sample exit routines 41 

obtaining a listing of sample sort exit routines 68 

obtaining a punched deck of TESTEXIT 62 

JES2 (job entry subsystem) 1 3, 55, 59 

JES2 records 

JES2 integrity (type 49) 1 24 

JES2 job purge (type 26) 1 08 

JES2 SIGNOFF/stop line (type 48) 123 

JES2 SIGNON/start line (type 47) 122 

JES2 start (type 43) 120 

JES2 withdrawal (type 45) 121 

JES2 writer (type 6) 86 

JES3 (job entry subsystem) ^ 13, 55, 59 

JES3 records 

JES3 device allocation (type 25) 107.1 (VS2.03.812) 
JES3 integrity (type 49) 124.1 (VS2.03.8 12) 
JES3 job purge (type 26) 110.1 (VS2.03.812) 
JES3 SIGNOFF/stop line (type 48) 123.1 (VS2.03.812) 
JES3 SIGNON/start line (type 47) 122.1 (VS2.03.8 12) 
JES3 start (type 43) 120.1 (VS2.03.812) 
JES3 stop (type 45) 121.1 (VS2.03.8 12) 
JES3 writer (type 6) 88.1 (VS2.03.812) 

job CPU time limit 53 

job initiation exit routine (see IEFUJI exit routine) 

job initiation record (type 20) 102 

job output element 

record written for 86 

job purge exit routine (see IEFUJP exit routine) 

job purge record, JES2 (type 26) 108 

job purge record, JES3 (type 26) 1 10.1 (VS2.03.8 12) 

job statement accounting field scan exit (HASPRSCN) 50 



job termination records 

for background jobs (type 5) 83 

for foreground jobs (type 35) 116 
job validation exit routine (see IEFUJV exit routine) 
job wait time limit 

Changing value of 53 

specifying (JWT parameter) 34 
JWT parameter (see also job wait time limit) 34 

keys, storage protect 43 

libraries, distribution 

for adding exit routines 23 
libraries, system (see SYS1 jcxxxxxx) 
load module assignments for exit routines 23 
local system queue area (LSQA) 

SMF storage requirements for 25 

subpools in 46 
logoff record (type 35 ) 116 
logon 

record written for 102 
LONG=YES parameter 

use with WTOR macro 43 
LSQA (local system queue area) 

SMF storage requirements for 25 

subpools in 46 

macro instructions 

GETMAIN 46,60 

IFASMFR 48 

SMFWTM 47 

WAIT 44 

WTOR 44 
magnetic tape volumes 

error statistics record for 103 
MAN parameter *34, 36 
MANX data set 

SMFWTM macro definition for writing to 61 
mass storage control (MSC) 

configuration 105 

varying offline 93 

varying online 91 
messages, SYSOUT 

from IEFACTRT 57 

from IFASMFDP 29 
MF/1 records 

channel activity (type 73) 141 

CPU activity (type 70) 1 35 

device activity (type 74) 143 

paging activity (type 71) 137 

workload activity (type 72) 1 39 
MF/1 termination 

records written for 1 35 , 1 37 
MODIFY team operator command 

record written when issued 111 
module assignments for exit routines 23 
modules interfacing with exit routines 40 
MSC (see mass storage control) 

non-VSAM data set activity records 

INPUT or RDBACK (type 14) 94 

OUTPUT, UPD AT, INOUT or OUTIN (type 15) 97 
non-VSAM data sets 

closing 94, 97 

renaming 99 

scratching 98 



opening VSAM components or clusters 

operating system 

including exit routines in 23 
relationship of SMF in 17 



125 
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operation of SMF, example of 18 

operator commands (see commands, operator) 

operator intervention parameter (OPI) 35 

OPI parameter 35 

OPT parameter 35,36 

OUTIN, OUTPUT, UPDAT or INOUT data set activity 

record (type 15) 97 
OUTLIM parameter 55 
OUTPUT, UPDAT, INOUT or OUTIN data set activity 

record (type 15) 97 
output writer record, JES2 (type 6) 86 
output writer record, JES3 (type 6) 88.1 (VS2.03.812) 

pageable link pack area (PLPA) 

SMF storage requirements for 25 
paging activity record (type 71) 137 
parameter area, common exit 45 
parameters, SMFPRMxx 

adding or replacing from console 37 

coding restrictions 37 

contents and formats 34 

defaults 36 

entering into SYS1 .PARMLIB 36 

selecting records using 36 

verification of 17 
performance, SMF 31 
PLPA (pageable link pack area) 

SMF storage requirements for 25 
purging a job , J ES2 1 08 
purging a job, JES3 110.1 (VS2.03.812) 

RDBACK or INPUT data set activity record (type 1 4) 94 

RDW (record descriptor word) 7 1 , 48 

real storage requirements, SMF 25 

REC parameter 35, 36 

record descriptor word (RDW) 7 1 , 48 

record length 

minimum for using sort 67 
recording not available record (type 7) 89 
records, SMF 

contents and formats 74 

introduction to 1 3-1 7 

segmenting 25,29 

selecting 36 

sizes 26 

sorting 67 

standard header 71 

sui maryof 72 

types (see "CONTENTS" for specific SMF record types) 
recovery 

allocation record (type 10) 92 
reenterable attribute 43 
register usage 43 

removing devices from configuration 93, 105 
renaming non-VSAM data sets 99 
renaming VSAM catalog entries 133 
report programs 

designing 70 

introduction 21 

sample (SMFFRMT) 70 
restarting a line, JES2 122, 123 
restarting a line, JES3 122.1, 123.1 (VS2.03.812) 
restrictions, exit routine (see also restrictions, SMF) 

adding exit routines to system 23 

adding or modifying JCL cards 50 

coding TIME=1 440 53 

communicating with IEFU83 59 

extending job/step execution time 5 3 

reenterable attrib ute 4 3 

resolving symbolic parameters 50 

system interlock 53 

using HASPRSCN with IEFUJV 50 



restrictions, exit routine (see also restrictions, SMF) (continued) 

writing to installation-defined data sets 43 

writing to SMF-defined data sets 47 

WTOR macro instruction 

use with LONG=YES parameter 44 
restrictions, SMF (see also restrictions, exit routine) 

coding SMFPRMxx parameters 37 

DCB= keyword with SMF dump program 29 

maximum SYSOUT message length 57 

minimum record length for sort 67 

reducing SMF buffer size 26, 34 

using SMF 13 
return codes 

IEFACTRT exit routine 52 

IEFUJI exit routine 52 

IEFUJP exit routine 59 

IEFUJV exit routine 51 

IEFUSI exit routine 52 

IEFUSO exit routine 56 

IEFUTL exit routine 55 

IEFU29 exit routine 59 (VS2.03.807) 

IEFU83 exit routine 56 

SMF dump program 29 

SMFWTM macro instruction 47 
RJP line, canceling 123.1 (VS2.03.8 12) 
routines, user-written 

exit (see exit routines, SMF) 

report 

designing 70 
introduction 21 
sample (SMFFRMT) 70 

S JES2 operator command 

record written when issued 1 20 
sample exit routines 41 
sample report program 70 
sample sort exit routines 67 
sample sort procedure 68 
saving registers 43 
scratching non-VSAM data sets 98 
selecting SMF records 

using SMFPRMxx parameters 36 
SET DATE operator command 

record written when issued 90 
SID parameter 35 

SIGNOFF/stop line record, JES2 (type 48) 123 
SIGNOFF/stop Hne record, JES3 (type 48) 123.1 (VS2.03.812) 
SIGNON/ start line record, JES2 (type 47) 1 22 
SIGNON/start Hne record, JES3 (type 47) 1 22.1 (VS2.03.8 12) 
sizes of SMF records 26 

minimum for using sort 67 
SMC A (system management control area) 

storage requirements 25 
SMF 

defining the use of 33 

definition of 1 3 

exits (see exit routines, SMF) 

initializing 1 7 

operation, example of 17 

performance 31 

records (see records, SMF) 

restrictions (see restrictions, SMF) 

storage requirements 25 
SMF buffer 

specifying size of 34 

storage requirements 25 
SMF data sets 

allocating space for 27 

cataloging 27 

determining which to write to first 19 

dumping 31 

specifying in SMFPRMxx parameters 33 



Index 173 



SMF data sets {continued) 

storage requirements 27 

switching 30 

writing to using SMFWTM macro 47 
SMF dump exit routine {see IEFU29 exit routine) (VS2.03.807) 
SMF dump program {see IFASMFDP) 
SMF exit parameter (EXT) 34 
SMF exit routines {see exit routines, SMF) 
SMF options 

list of 45 
SMF performance 31 

SMF record exit routine {see IEFU83 exit routine) 
SMF records {see records, SMF) 
SMF writer routine 

storage requirements 25 
SMF/user records parameter (MAN) 34, 36 
SMFDUMP procedure 42 (VS2.03.807) 
SMFEXITS sample exit routines 41 
SMFE1 5 sample sort routine 67 
SMFE35 sample sort routine 67 
SMFFRMT procedure 70 
SMFSORT procedure 68 
SMFWTM macro instruction 

format 47 

RDW used with 48, 71 

return codes 48 

TESTEXIT definition of 61 
SMFPRMxx parameters 

adding or replacing from console 37 

coding restrictions 37 

contents and formats 34 

defaults 36 

entering into SYS1 .PARMLIB 36 

selecting records using 36 

verification of 17 
sorting SMF records 

introduction 21 

minimum record length 44 

sample sort exit routines 67 

sample sort procedure 69 
space unavailable on VSAM volumes 1 28 
spin data sets 

JES2 record written for 86 

JES3 record written for 88.1 (VS2.03.812) 
SQA (system queue area) 

SMF storage requirements for 25 

subpools in 46 
standard SMF header 71 
START operator command 

use with SMF dump program 30 
starting J ES2 120 
starting JES3 120.1 (VS2.03.8 12) 
starting a line, JES2 121 
starting a line,JES3 121.1 (VS2.03.8 12) 
step CPU time limit 5 3 

step initiation exit routine {see IEFUSI exit routine) 
step termination records 

for background jobs (type 4) 78 

for foreground jobs (type 34) 112 
STOP operator command 

records written when issued 1 35, 1 37 
stopping a line, JES2 123 
stopping a line, JES3 123.1 (VS2.03.812) 
storage protect keys 43 
storage requirements, SMF 25 
subpools 

required for additional work areas 46 

required when using TESTEXIT 60 
subsystem records 15 
SVC 83 routine 56 



SWITCH operator command 

function 30 

record written when issued 100 
switching recording on SMF data sets 30 
switching VSAM volumes 128 
symbolically addressing SMF record fields 48 
SYSOUT limit exit routine {see IEFUSO exit routine) 
SYSOUT messages 

from IEFACTRT 57 

from IFASMFDP 29 
system identification parameter (SID) 35 
system interlock warning 53 
system libraries {see SYS1 .xxxxxxx) 
system management control area (SMCA) 

storage requirements 25 
system output messages 

from IEFACTRT 57 

from IFASMFDP 29 
system queue area (SQA) 

SMF storage requirement for 25 

subpools in 46 
system records 1 6 

system/job/ step parameter (OPT) 35, 36 
SYS1.ALPALIB 

adding exit routines to 23 
SYS1.AMODGEN 48 
SYS1.AOSB3 

adding exit routines to 23 
SYS1.AOS00 

adding exit routines to 23 
SYS1.ASAMPLIB 

SMFDUMP 42 (VS2.03.807) 

SMFEXITS 41 

SMFE15 67 

SMFE35 67 

SMFFRMT 70 

SMFSORT 68 

TESTEXIT 59 
SYS1.LPALIB 

adding exit routines to 24 
SYS1 .MACLIB 47 
SYS1.MANX {see SMF data sets) 
SYS1.MANY {see SMF data sets) 
SYS1 .PARMLIB 

adding dump procedure to 30 

adding SMFPRMxx member to 36 

TCT (timing control table) 

storage requirements 25 
temporary data set parameter (REC) 35, 36 
termination exit routine {see IEFACTRT exit routine) 
termination, JES2 record written for 121 
termination, JES3 record written for 1 21 .1 (VS2.03.8 12) 
termination records 

for background jobs (type 5) 83 

for background steps (type 4) 78 

for foreground jobs (type 35) 116 

for foreground steps (type 34) 112 
TESTEXIT procedure 

execution, summary of 65 

exit routine requirements for 60 

input/output and control flow of 60 

modifying 65 

obtaining from SYS1 .ASAMPLIB 62 

sample JCL for invoking 63 
testing exit routines 59 
throughput 31 
time extension, minimum 54 
time limit exit routine {see IEFUTL exit routine) 
time limits 53 



174 OS/VS2 System Management Facilities (SMF) (VS2.03.8 10) 



53 



111 
112 



TIME= parameter 

use in eliminating job/step timing 
timer interruption handler 53 
timer units 54 
timing control table (TCT) 

storage requirements 25 
TIOC initialization record (type 31 ) 
TS-step termination record (type 34) 
TSO records 

logoff (type 35) 116 

TS-step termination (type 34) 112 



unallocation request 

record written when issued 1 1 8 
UPDAT, OUTPUT, INOUT or OUTIN data set activity 

record (type 15) 97 
user-communication field 45 
user-defined data sets 43 
user-identification field 45 
user-written exit routines (see exit routines, SMF) 
user-written routines 

exit (see exit routines, SMF) 
report 

designing 70 
introduction 21 
sample (SMFFRMT) 70 
user/SMF records parameter (MAN) 34, 36 
utility programs (see IEBDG, IEBPTPCH, IEBUPDTE, IEHUCAT 
or IFHSTATR) 



writer record, JES2 (type 6) 86 

writer record, JES3 (type 6) 88.1 (VS2.03.812) 

writer routine, SMF 

storage requirements 25 
writing system output messages 57 
WTOR macro instruction 

use with WAIT macro 44 

3800 printing subsystem (VS2.03.810) 
JES2 writer record 86 (VS2.03.810) 
JES3 writer record 88.1 (VS2.03.810) 

3850 mass storage control 
configuration 105 
varying offline 93 
varying online 91 



VARY CH operator command 

record written when issued 1 05 
VARY CPU operator command 

record written when issued 1 05 
VARY OFFLINE operator command 

record written when issued 93 
VARY OFFLINE.S operator command 

record written when issued 105 
VARY ONLINE operator command 

record written when issued 91 
VARY ONLINE,S operator command 

record written when issued 105 
VARY STOR operator command 

record written when issued 105 
volume error statistics record (type 21) 103 
volume records 17 
volumes 

magnetic tape 103 

VSAM 128 
VSAM component or cluster opened record (type 62) 125 
VSAM component or cluster status record (type 64) 128 
VSAM data sets 

records written for 1 25-1 34 
VSAM data space defined, extended, or deleted record 

(type 69) 1 34 
VSAM entry defined record (type 63) 1 26 
VSAM entry deleted record (type 67) 1 31 
VSAM entry renamed record (type 68) 1 33 



44 



WAIT macro instruction 

use with WTOR macro 
wait time 

specifying limit of (JWT parameter) 
warm start 

JES2 record written for 

JES3 record written for 

parameter modifications 
withdrawing JES2 121 
work areas 

obtaining additional 46 
workload activity record (type 72) 



34 



120 

120.1 (VS2.03.812) 

33 



139 



Index 175 



0S/VS2 System Programming Library: 
System Management Facilities (SMF) 
GC28-0754-0 



Your views about this publication may help improve its usefulness; this form 
will be sent to the author's department for appropriate action. Using this 
form to request system assistance or additional publications will delay response, 
however. For more direct handling of such requests, please contact your 
IBM representative or the IBM Branch Office serving your locality. 

Possible topics for comment are: 

Clarity Accuracy Completeness Organization Index Figures Examples Legibility 



What is your occupation? ■ 

Number of latest Technical Newsletter (if any) concerning this publication: 

Please indicate your name and address in the space below if you wish a reply. 



Thank you for your cooperation. No postage stamp necessary if mailed in the U.S.A. 
(Elsewhere, an IBM office or representative will be happy to forward your comments.) 



GG28-0754-0 



Your comments, please ... 

This manual is part of a library that serves as a reference source for system analysts, 
programmers, and operators of IBM systems. Your comments on the other side of this 
form will be carefully reviewed by the persons responsible for writing and publishing 
this material. All comments and suggestions become the property of IBM. 



Fold 



Fold 



■-I 



First Class 
Permit 81 
Poughkeepsie 
New York 



Business Reply Mail 

No postage stamp necessary if mailed in the U.S.A. 



Postage will be paid by: 

International Business Machines Corporation 

Department D58, Building 706-2 

PO Box 390 

Poughkeepsie, New York 1 2602 




-I 



Fold 



Fold 



International Business Machines Corporation 

Data Processing Division 

1133 Westchester Avenue, White Plains, New York 10604 

(U.S.A. only) 

IBM World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 

(international) 



